3.1.4.1 Printer Management Methods

The Printer Management methods support the discovery, access, and configuration of printer and print server objects. The following table presents a list of printer management methods and their counterparts in the Print System Remote Protocol [MS-RPRN]. All methods are specified in sections that follow.

Parameter descriptions, parameter validation, and processing and response requirements that are not specified in methods of this protocol are specified in the corresponding methods of the Print System Remote Protocol.

[MS-PAR] method

Description

Corresponding [MS-RPRN] method

RpcAsyncOpenPrinter

Retrieves a handle to a specified printer or print server. A client uses this method to obtain a print handle to an existing printer on a remote machine.

Opnum 0

RpcOpenPrinterEx

RpcAsyncAddPrinter

Installs a printer on the print server.

Opnum 1

RpcAddPrinterEx

RpcAsyncDeletePrinter

Deletes the specified printer object.

The client MUST call RpcAsyncClosePrinter (section 3.1.4.1.10) with the same printer handle after calling this method.

Opnum 7

RpcDeletePrinter

RpcAsyncSetPrinter

Sets the state of a specified printer, optionally by performing an action to change the state.

Opnum 8

RpcSetPrinter

RpcAsyncGetPrinter

Retrieves information about a specified printer.

Opnum 9

RpcGetPrinter

RpcAsyncGetPrinterData

Retrieves printer data from a specified printer or print server.

Opnum 16

RpcGetPrinterData

RpcAsyncGetPrinterDataEx

Retrieves configuration data for the specified printer or print server.

Opnum 17

RpcGetPrinterDataEx

RpcAsyncSetPrinterData

Sets the configuration data for a printer or print server.

Opnum 18

RpcSetPrinterData

RpcAsyncSetPrinterDataEx

Sets the configuration data for a printer or print server.

Opnum 19

RpcSetPrinterDataEx

RpcAsyncClosePrinter

Closes a handle to a printer, server, job or port object that was opened by calling RpcAsyncOpenPrinter (section 3.1.4.1.1) or RpcAsyncAddPrinter (section 3.1.4.1.2).

Opnum 20

RpcClosePrinter

RpcAsyncEnumPrinterData

Enumerates configuration data for a specified printer.

Opnum 27

RpcEnumPrinterData

RpcAsyncEnumPrinterDataEx

Enumerates all value names and data for a specified printer and key.

Opnum 28

RpcEnumPrinterDataEx

RpcAsyncEnumPrinterKey

Enumerates the subkeys of a specified key for a specified printer.

Opnum 29

RpcEnumPrinterKey

RpcAsyncDeletePrinterData

Deletes a specified value from the configuration of a specified printer.

Opnum 30

RpcDeletePrinterData

RpcAsyncDeletePrinterDataEx

Deletes a specified value from the configuration data of a specified printer, which consists of a set of named and typed values stored in a hierarchy of registry keys.

Opnum 31

RpcDeletePrinterDataEx

RpcAsyncDeletePrinterKey

Deletes a specified key and all of its subkeys from the configuration of a specified printer.

Opnum 32

RpcDeletePrinterKey

RpcAsyncSendRecvBidiData

Sends and receives bidirectional data. This method is used to communicate with print monitors that support such data.

Opnum 34

RpcSendRecvBidiData

RpcAsyncCreatePrinterIC

Creates an information context on a specified printer.

Opnum 35

RpcCreatePrinterIC

RpcAsyncPlayGdiScriptOnPrinterIC

Queries fonts for printer connections.

Opnum 36

RpcPlayGdiScriptOnPrinterIC

RpcAsyncDeletePrinterIC

Deletes a printer information context.

Opnum 37

RpcDeletePrinterIC

RpcAsyncEnumPrinters

Enumerates available local printers, printers on a specified print server, printers in a specified domain, or print providers.

Opnum 38

RpcEnumPrinters

RpcAsyncAddPerMachineConnection

Persistently saves the configuration information for a connection, including the print server name and the name of the print provider for a specified connection.

Opnum 55

RpcAddPerMachineConnection

RpcAsyncDeletePerMachineConnection

Deletes the stored connection configuration information that corresponds to the pPrinterName parameter value.

Opnum 56

RpcDeletePerMachineConnection

RpcAsyncEnumPerMachineConnections

Enumerates each of the per-machine connections into a specified buffer.

Opnum 57

RpcEnumPerMachineConnections

RpcAsyncResetPrinter

Resets the data type and device mode values to use for printing documents submitted by RpcAsyncStartDocPrinter method (section 3.1.4.8.1).

Opnum 69

RpcResetPrinter