Registering a Fax Routing Extension

A fax routing extension can be installed directly on a fax server (local installation), or from a computer on a network (remote installation). Local installation is recommended.

Local Installation

To register locally with the fax service, it is recommended that a fax routing extension DLL perform the following steps rather than directly accessing the registry.

To register locally with the fax service

1. Copy the fax routing extension DLL to the location specified by the ImageName parameter to the FaxRegisterRoutingExtension function.
2. Call the FaxConnectFaxServer function, specifying a NULL pointer in the MachineName parameter, to obtain a fax server handle to the local server.
3. Call the FaxRegisterRoutingExtension function to register the fax routing extension DLL.

You must restart the fax service to use a fax routing method exported by a fax routing extension you install using FaxRegisterRoutingExtension.

Remote Installation

Each fax routing extension DLL must provide the fax service with information about the extension by creating a subkey under the following registry key on the remote computer:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax\
Routing Extensions\<MyExtension Id>

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

It is recommended that the key name describe the fax routing extension. The identifier can be a company name. To register the extension, set the following two required values under the registry key.