Registering a Fax Routing Method

To provide the fax service with information about the fax routing extension's routing methods, the extension must create the following registry subkey:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax\
Routing Extensions\<MyExtensionID>\Routing Methods

where <MyExtensionID> is the registry key name the fax routing extension creates to register itself.

The fax routing extension must also create the following registry subkey for each fax routing method the extension exports. It is recommended that each subkey name describe the fax routing method the extension is registering.

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax\Routing Extensions\<MyExtensionID>\Routing Methods\<MyMethodDescription>

To register a fax routing method, set the following two required values under the registry subkey.

The FunctionName entry must contain the exact name of the function that runs the fax routing method. The entry is case sensitive, and it must include name decoration. The fax server uses this entry in a call to the GetProcAddress function, to retrieve the address of the function that runs a specific fax routing method. For more information about fax routing methods, see Routing a Fax.

To generate a GUID for a routing method, you can run the utility UUIDGEN.EXE. A GUID that you format for the registry must be a null-terminated string enclosed in curly braces, as in the following example:

{12340001-4980-1920-6788-123456789012}

A GUID is necessary to identify a fax routing method for the following reasons:

• A fax routing extension DLL can support multiple routing methods.
• A fax routing extension DLL can maintain unique configuration data for each routing method and for each fax device.
• Multiple fax routing extension DLLs can export routing methods with the same name.

For more information about GUIDs, see Managing GUIDs.