3.1.4.1.10 RpcAsyncClosePrinter (Opnum 20)

  • Article

RpcAsyncClosePrinter closes a handle to a printer, server, job, or port object that was previously opened by either RpcAsyncOpenPrinter (section 3.1.4.1.1) or RpcAsyncAddPrinter (section 3.1.4.1.2).

The counterpart of this method in the Print System Remote Protocol is RpcClosePrinter. All parameters not defined below are specified in [MS-RPRN] section 3.1.4.2.9.

 DWORD RpcAsyncClosePrinter(
   [in, out] PRINTER_HANDLE* phPrinter
 );

phPrinter: A pointer to the handle for a printer object, server object, job object, or port object.

Return Values: This method returns zero to indicate successful completion or a nonzero Win32 error code ([MS-ERREF] section 2.2) to indicate failure. The client MUST treat any nonzero return value as a fatal error.

Exceptions Thrown: This method MUST NOT throw any exceptions other than those that are thrown by the underlying RPC protocol [MS-RPCE].

This method MUST adhere to the parameter validation, processing, and response requirements that are specified in [MS-RPRN] section 3.1.4.2.9.