3.1.4.10.2 RpcAsyncSetJobNamedProperty (Opnum 71)

  • Article

RpcAsyncSetJobNamedProperty creates a new Job Named Property (section 3.1.1), or changes the value of an existing Job Named Property for the specified print job.<32>

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

 DWORD RpcAsyncSetJobNamedProperty(
   [in] PRINTER_HANDLE hPrinter,
   [in] DWORD JobId,
   [in] RPC_PrintNamedProperty* pProperty
 );

hPrinter: A handle to a printer object or server object that has been opened by using either RpcAsyncOpenPrinter (section 3.1.4.1.1) or RpcAsyncAddPrinter (section 3.1.4.1.2).

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 specified in [MS-RPCE].

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