Share via

3.1.4.2.6 FaxObs_ClosePort (Opnum 4)

  • Article

The client calls the FaxObs_ClosePort (Opnum 4) method to close a fax port and release the fax port handle obtained with a FaxObs_OpenPort (section 3.1.4.2.5) call.

On success, the server MUST close the specified port and release the handle.

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

FaxPortHandle: A pointer to a fax port handle obtained with a FaxObs_OpenPort call.

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 the FAX_PORT_QUERY access rights required for this operation.

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