Share via


PrinterElementsChangeEvent element

The required PrinterElementsChangeEvent element informs the client that a configuration change has occurred in the printer.

PrinterElementsChangeEvent is defined in the namespace at this URI: https://schemas.microsoft.com/windows/2005/05/wdp/print and referenced by the prefix wprt. (This resource may not be available in some languages and countries.)

Usage

<wprt:PrinterElementsChangeEvent>
  child elements
</wprt:PrinterElementsChangeEvent>

Attributes

There are no attributes.

Text value

None

Child elements

Element Description

ElementChanges

Contains the changes to the PrinterConfiguration, DefaultPrintTicket, or PrinterCapabilities elements, or changes to an IHV extension in the Printer.

Parent elements

There are no parent elements.

Remarks

The WSD Print Service must send a PrinterElementsChangeEvent element to the client when an element has changed within PrinterConfiguration, DefaultPrintTicket, PrinterCapabilities, or an IHV extension in the printer.

The body of PrinterElementsChangeEvent must contain an ElementChanges element with XML that describes the elements that have changed value. The ElementChanges element accepts any valid XML sequence. In this way, the Print Service can return only the data that has changed without a need to return a complete PrinterConfiguration, DefaultPrintTicket, or PrinterCapabilities element.

The client will pull the Print Service data elements out of the returned XML and update the client's internal data store.

The following syntax block shows that you must also prefix the names of the child elements with the appropriate namespace (in this case wprt), to be certain that your name references apply to child elements in the correct namespace.

<wprt:PrinterElementsChangeEvent>
 <wprt:ElementChanges> data </wprt:ElementChanges>
</wprt:PrinterElementsChangeEvent>

See also

DefaultPrintTicket

ElementChanges

PrinterCapabilities

PrinterConfiguration

 

 

Send comments about this topic to Microsoft

Build date: 7/19/2012