3.1.4.1.104 FAX_UnregisterServiceProviderEx (Opnum 61)

The FAX_UnregisterServiceProviderEx (Opnum 61) method is called when the client needs to unregister a fax service provider (FSP). In response, the server MUST validate that the client's fax user account has write access. On success, the server MUST remove the service provider for the fax server.<179>

 error_status_t FAX_UnregisterServiceProviderEx(
   [in] handle_t hFaxHandle,
   [in, string, ref] LPCWSTR lpcwstrGUID
 );

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.

lpcwstrGUID: A pointer to a constant null-terminated character string that contains a valid string representation of the GUID of the fax service provider (FSP). This value can be obtained with the FAX_EnumerateProviders (section 3.1.4.1.19) method.

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.

Return value/code	Description
ERROR_ACCESS_DENIED 0x00000005	Access is denied. The caller does not have the required FAX_ACCESS_MANAGE_CONFIG authorization for this operation.

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