Platform SDK: Fax Services

FAX_ROUTE_CALLBACKROUTINES

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; 

Members

SizeOfStruct
Specifies the size, in bytes, of the FAX_ROUTE_CALLBACKROUTINES structure. The fax service sets this member to sizeof(FAX_ROUTE_CALLBACKROUTINES). For information about backward compatibility, see the following Remarks section.
FaxRouteAddFile
Pointer to a FaxRouteAddFile callback function that a fax routing method uses to add a file to the fax file list associated with a received fax document.
FaxRouteDeleteFile
Pointer to a FaxRouteDeleteFile callback function that a fax routing method uses to delete a file from the fax file list associated with a received fax document.
FaxRouteGetFile
Pointer to a FaxRouteGetFile callback function that a fax routing method uses to retrieve a specific file name from the fax file list associated with a received fax document.
FaxRouteEnumFiles
Pointer to a FaxRouteEnumFiles callback function that a fax routing method uses to enumerate the files in the fax file list associated with a received fax document.
FaxRouteModifyRoutingData
Pointer to a FaxRouteModifyRoutingData callback function that a fax routing method uses to modify the routing data associated with a subsequent fax routing method.

Remarks

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.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Header: Declared in faxroute.h.

See Also

Fax Routing Extension Application Programming Interface Overview, Fax Routing Extension Structures, FAX_ROUTE_CALLBACKROUTINES, FaxRouteAddFile, FaxRouteDeleteFile, FaxRouteGetFile, FaxRouteEnumFiles, FaxRouteModifyRoutingData