18.104.22.168.20 FAX_EnumGlobalRoutingInfo (Opnum 17)
The server MUST validate that the client's fax user account has access to enumerate the global routing information. On success, the server MUST return all the fax routing methods associated with a specific fax server in RoutingInfoBuffer.
The client SHOULD free the returned buffer.
error_status_t FAX_EnumGlobalRoutingInfo( [in] handle_t hBinding, [out, size_is(, *RoutingInfoBufferSize)] LPBYTE* RoutingInfoBuffer, [out, ref] LPDWORD RoutingInfoBufferSize, [out, ref] LPDWORD MethodsReturned );
hBinding: The RPC binding handle for this call. The client SHOULD reuse the RPC binding handle used as an input hBinding argument for the FAX_ConnectFaxServer (section 22.214.171.124.10) or FAX_ConnectionRefCount (section 126.96.36.199.11) method call used to connect to the fax server.
RoutingInfoBuffer: A pointer to the address of a buffer to receive an array of _FAX_GLOBAL_ROUTING_INFOW (section 2.2.33) structures. Each structure contains information about one fax routing method, as it pertains to the entire Fax Service.
RoutingInfoBufferSize: A variable to return the size, in bytes, of the routing information buffer.
MethodsReturned: A pointer to a DWORD ([MS-DTYP] section 2.2.9) variable to receive the number of _FAX_GLOBAL_ROUTING_INFOW that the method returns in the RoutingInfoBuffer parameter. This number SHOULD equal the total number of fax routing methods installed on the target server.
Return Values: This method MUST return 0x00000000 (ERROR_SUCCESS) for success; otherwise, it MUST return one of the following error codes, one of the fax-specific errors that are defined in section 2.2.52, or one of the other standard errors defined in [MS-ERREF] section 2.2.
The server failed to enumerate the routing methods.
Access is denied. The client's fax user account does not have the FAX_ACCESS_QUERY_CONFIG access rights required for this operation.
The server cannot allocate sufficient memory to hold the array of _FAX_GLOBAL_ROUTING_INFOW structures to be returned to the client.
The RoutingInfoBuffer parameter is set to a NULL pointer value.<86>
The server failed to custom marshal the array of _FAX_GLOBAL_ROUTING_INFOW structures to be returned to the client.