Platform SDK: Fax Services

Fax Service Provider Registration

A fax service provider 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 service provider perform the following steps rather than directly accessing the registry.

To register locally with the fax service

  1. Install a telephony service provider for device abstraction. The telephony service provider identifies all the fax devices that the fax service provider controls, and enables the fax service to use the exposed fax devices.
  2. Copy the fax service provider DLL to the location specified by the ImageName parameter to the FaxRegisterServiceProvider function.
  3. Call the FaxRegisterServiceProvider function to configure the new devices for use by the fax service.

Remote Installation

Each fax service provider DLL must register with the fax service during a remote installation by providing information under the following key in the registry on the remote computer:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Fax\
Device Providers\OEM

To register the DLL, set the following three required values under this key.

Value Description
FriendlyName A REG_SZ string that contains the user-friendly display name for the fax service provider DLL.
ImageName A REG_EXPAND_SZ string that contains the full path and file name for the fax service provider DLL.
ProviderName A REG_SZ string that contains the telephony service provider name.

It is recommended that you store registry data that is specific to the fax service provider under this key. Because all configuration is the responsibility of the fax service provider, configuration data should be stored under this key.