Platform SDK: Fax Services

Local Registration of 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.

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 install an extension and register locally

  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 with the fax service. The function calls the FAX_ROUTING_INSTALLATION_CALLBACK function once for each fax routing method in the fax routing extension DLL.

If you install a fax routing extension by using a call to FaxRegisterRoutingExtension, you must restart the fax service to use a fax routing method exported by that extension.

For information about registering from a remote computer, see Fax Routing Extension Registration. For information about developing a routing extension dynamic-link library (DLL), see Fax Routing Extension API.