4
December 15, 1997
Protocols
4
Protocols
Release 6.4
X Version 11
If printer-name is an empty string, then a list of all printers is returned. Otherwise the print record that
matches the printer-name specified is returned. If no records match printer-name, then an empty list is
returned.
printer-name is a COMPOUND_TEXT string. The name and description fields returned are
COMPOUND_TEXT. If printer-name is provided in a code-set that the print server cannot convert, then it
may not be possible to locate the requested printer.
The locale argument is used as a "hint" to locate a localized description for each printer in the list. If the
print server cannot interpret the hint, then it describes the printers in the server's current locale.
PrintGetScreenOfContext
root: WINDOW
Errors: XPBadContext
This request returns the root window associated with the current print context.
Each printer supported by a print server is associated with exactly one of the screens returned in the connec-
tion setup reply.
PrintStartJob
output-mode: {XPSpool, XPGetData}
Errors: XPBadSequence, Value
This request signals the beginning of a new print job. It results in the generation of an XPPrintNotify event,
with the detail field set to XPStartJobNotify.
If output-mode is set to XPSpool, then the document data is typically sent to a spooler.
If output-mode is set to XPGetData, then the document data is made available to PrintGetDocumentData
and the resulting job is not spooled. In this case, the print server suspends processing further requests on this
print context until some other client sends PrintGetDocumentData. Subsequent operations that use the
print context may be suspended at any time pending the processing of PrintGetDocumentData replies to
read any buffered output.
Any changes to the XPJobAttr pool must be made before PrintStartJob. Further modifications can only be
made to the attribute pool after a PrintEndJob request is executed.
PrintEndJob
cancel: BOOL