background image
2
December 15, 1997
Protocols
2
Protocols
Release 6.4
X Version 11
2
Protocols
2.1
Formats, Syntactic Conventions, and Common Types
The type PCONTEXT is a 32-bit value. Its top three bits are guaranteed to be zero.
Refer to the X Window System Protocol specification for a description of other formats, syntactic conven-
tions and common types established in that publication and used in the current document as well.
2.2
Errors
X Print Service can return the following messages, in addition to X core request errors.
XPBadContext
An incorrect print context ID was specified.
XPBadSequence
Requests were not specified in the proper order with respect to other
requests. For example, a request was specified before a PrintSetContext
request.
Other errors that are context specific for a particular request are documented in the description of the request
itself. If the above errors have a specific meaning for a particular request, they are documented in the request
itself as well.
2.3
X Print Service Requests
PrintCreateContext
context-id: PCONTEXT
printer-name: STRING8
locale: STRING8
Errors: Match, IDChoice
This request creates a new print context and assigns context-id to it. The attributes associated with the new
context are those determined by the printer-name. Printer-name is encoded in COMPOUND_TEXT.
The client must select the context-id by ORing some combination of bits in the connection resource-id-mask
with the resource-id-base.
The locale argument is used as a "hint" to the print server, and is used to initialize attribute pools with any
localized attribute values.
A Match error is generated when the printer-name does not exist.