Platform SDK: Fax Services |
The FaxRouteGetRoutingInfo function queries the fax routing extension DLL to obtain routing configuration data for a specific fax device. Each fax routing extension DLL must export the FaxRouteGetRoutingInfo function.
BOOL WINAPI FaxRouteGetRoutingInfo( LPCWSTR RoutingGuid, // pointer to the GUID for the // routing method DWORD DeviceId, // identifier of the fax device to query LPBYTE RoutingInfo, // pointer to the buffer to // receive configuration data LPDWORD RoutingInfoSize // pointer to the buffer size, in bytes );
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, the fax service calls GetLastError.
The fax service calls the FaxRouteGetRoutingInfo function twice. On the first call to the function the fax service passes a NULL pointer in the RoutingInfo parameter. The fax routing extension DLL must set the RoutingInfoSize parameter to the size required for the RoutingInfo buffer. The fax service calls FaxRouteGetRoutingInfo a second time with a valid pointer to the RoutingInfo buffer.
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, FaxRouteSetRoutingInfo