Platform SDK: Fax Services |
The FAX_ROUTING_INSTALLATION_CALLBACK function is a library-defined callback function that the FaxRegisterRoutingExtension function calls to install a fax routing extension DLL. FaxRegisterRoutingExtension calls the FAX_ROUTING_INSTALLATION_CALLBACK function multiple times, once for each fax routing method the fax routing extension exports.
The PFAX_ROUTING_INSTALLATION_CALLBACK data type is a pointer to a FAX_ROUTING_INSTALLATION_CALLBACK function.
BOOL CALLBACK FAX_ROUTING_INSTALLATION_CALLBACK( HANDLE FaxHandle, //handle to the fax server LPVOID Context, //pointer to context information LPWSTR MethodName, //pointer to fax routing method internal name LPWSTR FriendlyName, //pointer to fax routing method // user-friendly name LPWSTR FunctionName, //pointer to fax routing method function name LPWSTR Guid //pointer to GUID that // identifies the fax routing method );
The FAX_ROUTING_INSTALLATION_CALLBACK function returns a value of nonzero to indicate that the FaxRegisterRoutingExtension function should register the fax routing method for the fax routing extension, using the data pointed to by the parameters.
The function returns a value of zero to indicate that there are no more fax routing methods to register, and calls to FAX_ROUTING_INSTALLATION_CALLBACK should be terminated. To get extended error information, call GetLastError.
A fax client application specifies the FAX_ROUTING_INSTALLATION_CALLBACK function by passing its address when it calls the FaxRegisterRoutingExtension function. For more information, see Local Registration of a Fax Routing Extension.
For information about fax routing extensions, see About the Fax Routing Extension API.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Requires Windows 95 or later. Available as a redistributable with BackOffice Small Business Server.
Header: Declared in Winfax.h.
Unicode: Declared as Unicode and ANSI prototypes.
Fax Service Client Application Programming Interface Overview, Fax Service Client API Functions, FaxRegisterRoutingExtension, FaxConnectFaxServer