Platform SDK: Fax Services |
A fax routing method calls the FaxRouteEnumFiles callback function to enumerate the files in the fax file list associated with a received fax document. FaxRouteEnumFiles passes a pointer to the FaxRouteEnumFile callback function.
BOOL WINAPI FaxRouteEnumFiles( DWORD JobId, // fax job identifier GUID *Guid, // pointer to the GUID for the routing method PFAXROUTEENUMFILE FileEnumerator, // pointer to file enumeration callback function PVOID Context // pointer to an extension-defined value );
If the function succeeds, the return value is a nonzero value.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
The fax service passes a pointer to the FaxRouteEnumFiles callback function when the fax service calls the FaxRouteInitialize function. The service passes the pointer in a FAX_ROUTE_CALLBACKROUTINES structure.
The PFAXROUTEENUMFILES data type is a pointer to a FaxRouteEnumFiles function.
The fax routing extension DLL must supply the FaxRouteEnumFile function specified by the FileEnumerator parameter. The fax service calls FaxRouteEnumFile to enumerate the files in the fax file list for the fax routing method. The fax service calls FaxRouteEnumFile once for each file in the fax file list.
For more information, see Fax File Lists.
Windows NT/2000: Requires Windows 2000.
Windows 95/98: Unsupported.
Header: Declared in faxroute.h.
Import Library: User-defined.
Fax Routing Extension Application Programming Interface Overview, Fax Routing Extension Functions, FAX_ROUTE_CALLBACKROUTINES, FaxRouteEnumFile, FaxRouteInitialize