Platform SDK: Fax Services |
A fax management application calls the FaxSetGlobalRoutingInfo function to modify fax routing method data, such as routing priority, that applies globally to the fax server.
BOOL WINAPI FaxSetGlobalRoutingInfo( HANDLE FaxHandle, //handle to the fax server CONST FAX_GLOBAL_ROUTING_INFO *RoutingInfo //pointer to global routing information structure );
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError. GetLastError can return one of the following errors.
Error code | Description |
---|---|
ERROR_ACCESS_DENIED | Access is denied. FAX_CONFIG_SET access is required. |
ERROR_INVALID_DATA | The Guid member of the specified FAX_GLOBAL_ROUTING_INFO structure does not correspond to an installed fax routing method. |
ERROR_INVALID_PARAMETER | One or both of the FaxHandle or RoutingInfo parameters are invalid. |
An application such as the fax service administration application, an MMC snap-in component that manages the specified fax routing method, typically calls the FaxSetGlobalRoutingInfo function.
To retrieve the current global configuration, call the FaxEnumGlobalRoutingInfo function. Call the FaxEnumRoutingMethods function to enumerate the fax routing methods associated with a particular device. For more information, see Managing Fax Routing Data.
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.
Library: Included as a resource in Winfax.dll.
Unicode: Implemented as Unicode and ANSI versions on all platforms.
Fax Service Client Application Programming Interface Overview, Fax Service Client API Functions, FaxEnumRoutingMethods, FaxEnumGlobalRoutingInfo, FAX_GLOBAL_ROUTING_INFO