Platform SDK: Fax Services |
The FAX_ROUTE_CALLBACKROUTINES structure contains pointers to callback functions the fax service provides. A fax routing extension's routing methods can call these callback functions to manage the files in the fax file list associated with a received fax document.
typedef struct _FAX_ROUTE_CALLBACKROUTINES { DWORD SizeOfStruct; // structure size, in bytes PFAXROUTEADDFILE FaxRouteAddFile; //pointer to callback that adds fax routing files PFAXROUTEDELETEFILE FaxRouteDeleteFile; //pointer to callback that deletes fax routing files PFAXROUTEGETFILE FaxRouteGetFile; //pointer to callback that retrieves routing file name PFAXROUTEENUMFILES FaxRouteEnumFiles; //pointer to callback that enumerates routing files PFAXROUTEMODIFYROUTINGDATA FaxRouteModifyRoutingData; //pointer to callback that modifies routing data } FAX_ROUTE_CALLBACKROUTINES, *PFAX_ROUTE_CALLBACKROUTINES;
The fax routing extension DLL must store the pointers to these callback functions in a global variable for later use.
If the SizeofStruct member is greater than sizeof(FAX_ROUTE_CALLBACKROUTINES), this indicates that the FAX_ROUTE_CALLBACKROUTINES structure has been updated by Microsoft, and your application is using an earlier version. To maintain backward compatibility, changes will be appended to the original prototype of the FAX_ROUTE_CALLBACKROUTINES structure. For example, new members for additional callback functions will be added sequentially after the FaxRouteModifyRoutingData member.
For more information, see Fax Routing Extension Registration and Fax File Lists.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Unsupported.
Header: Declared in faxroute.h.
Fax Routing Extension Application Programming Interface Overview, Fax Routing Extension Structures, FAX_ROUTE_CALLBACKROUTINES, FaxRouteAddFile, FaxRouteDeleteFile, FaxRouteGetFile, FaxRouteEnumFiles, FaxRouteModifyRoutingData