3.1.4.14.1 RpcRegeneratePrintDeviceCapabilities (Opnum 117)

  • Article

RpcRegeneratePrintDeviceCapabilities regenerates the PrintDeviceCapabilities printer configuration file using IPP attributes obtained from a get-printer-attributes IPP request (see [RFC8011]).<403>

 DWORD
 RpcRegeneratePrintDeviceCapabilities(
   [in]    PRINTER_HANDLE  hPrinter
 );

hPrinter: A PRINTER_HANDLE (section 2.2.1.1.4) to a printer object that was opened by RpcAddPrinter (section 3.1.4.2.3), RpcAddPrinterEx (section 3.1.4.2.15), RpcOpenPrinter (section 3.1.4.2.2), or RpcOpenPrinterEx (section 3.1.4.2.14).

Return Values: This method MUST return zero (ERROR_SUCCESS) to indicate successful completion or a nonzero Windows error code to indicate failure [MS-ERREF].

Upon receiving this message, the server MUST validate the following:

  • Perform the validation steps that are specified in PRINTER_HANDLE Parameters (section 3.1.4.1.11).

If parameter validation fails, the server MUST fail the operation immediately and return a nonzero error response to the client. Otherwise, the server MUST process the message and compose a response to the client as follows:

  • Return the status of the operation.