Initializing a Fax Routing Extension

Each time the fax service starts, it calls the FaxRouteInitialize function once to initialize the fax routing extension. If the function succeeds, the fax service routes received faxes through the extension's fax routing methods, in order of priority. The fax routing extension must perform all necessary initialization when the fax service calls FaxRouteInitialize.

The fax service passes pointers to the FaxRouteAddFile, FaxRouteDeleteFile, FaxRouteGetFile, FaxRouteModifyRoutingData, and FaxRouteEnumFiles callback functions when the fax service calls FaxRouteInitialize. The service passes the pointers in a FAX_ROUTE_CALLBACKROUTINES structure. The extension's fax routing methods call these callback functions to manage the files in the fax file list associated with a received fax document. The fax routing extension must store these callback function pointers in a global variable for later use.

The fax routing extension must export the FaxRouteInitialize function.

For more information about registering with the fax service during installation, see Fax Routing Extension Registration. For more information about tasks the fax routing extension must perform at initialization time, see Enumerating Available Fax Devices.