3.1.4.1.9 FAX_ClosePort (Opnum 3)

The FAX_ClosePort (Opnum 3) method is called by the client to close an open fax port. The client passes FaxPortHandle, which it received from a call to FAX_OpenPort (section 3.1.4.1.65).

In response, the server MUST validate that the port handle specified by the FaxPortHandle argument is a valid open port handle returned by a call to FAX_OpenPort. On success, the server MUST close the specified port.

 error_status_t FAX_ClosePort(
   [in, out] PRPC_FAX_PORT_HANDLE FaxPortHandle
 );

FaxPortHandle: A pointer to a fax port handle.

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_INVALID_HANDLE

0x00000006

FaxPortHandle is not a valid open port handle returned by FAX_OpenPort. <71>

ERROR_INVALID_PARAMETER

0x00000057

The RPC_FAX_PORT_HANDLE fax data type referenced by the FaxPortHandle parameter is set to a NULL pointer value.<72>

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