3.1.4.1.103 FAX_UnregisterRoutingExtension (Opnum 62)

  • Article

The FAX_UnregisterRoutingExtension (Opnum 62) method unregisters an existing inbound routing extension.<178>

There are no corresponding routing extension registration functions exposed to the FAX client. Registration is a non-RPC process that is done locally on the fax server using any implementation-specific method.

On success, the server MUST unregister the specified routing extension.

 error_status_t FAX_UnregisterRoutingExtension(
   [in] handle_t hFaxHandle,
   [in, string, ref] LPCWSTR lpcwstrExtensionName
 );

hFaxHandle: 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 3.1.4.1.10) or FAX_ConnectionRefCount (section 3.1.4.1.11) method call used to connect to the fax server.

lpcwstrExtensionName: Specifies the name of the fax routing extension returned by the FAX_EnumRoutingExtensions (section 3.1.4.1.30) call as the lpcwstrExtensionName field of the FAX_ROUTING_EXTENSION_INFO (section 2.2.49) structure representing the respective fax routing extension.

Return Values: This method MUST return 0x00000000 (ERROR_SUCCESS) for success; otherwise, it MUST return the following error code, 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.

Return value/code

Description

ERROR_ACCESS_DENIED

0x00000005

Access is denied. The client's fax user account does not have sufficient rights to perform the operation (FAX_ACCESS_MANAGE_CONFIG) or the user account does not exist.

Exceptions Thrown: No exceptions are thrown except those that are thrown by the underlying RPC protocol, [MS-RPCE].