3.1.4.1.15 FAX_EndCopy (Opnum 72)

  • Article

The FAX_EndCopy (Opnum 72) method is called by the client to end a copy operation process from or to the server, and to close the respective copy handle.

On success, the server MUST terminate the specified copy operation previously begun with FAX_StartCopyToServer (section 3.1.4.1.97) or FAX_StartCopyMessageFromServer (section 3.1.4.1.96).

 error_status_t FAX_EndCopy(
   [in, out, ref] PRPC_FAX_COPY_HANDLE lphCopy
 );

lphCopy: A copy handle that MUST be returned by FAX_StartCopyToServer or FAX_StartCopyMessageFromServer.

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

This error code SHOULD be returned if the handle pointed to by the specified lphCopy parameter is not a valid handle returned by FAX_StartCopyToServer or FAX_StartCopyMessageFromServer.<78>

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