24
December 15, 1997
X Print Service Extension Library
24
X Print Service Extension Library
Release 6.4
X Version 11
Display *display;
display
Specifies a pointer to the Display structure; returned from XOpenDisplay.
XpRehashPrinterList causes the X Print Server to recompute (update) its list of available printers, and update
the attributes for the printers. The intended usage of this routine is in a special tool that a system administra-
tor can run after changing the printer topology. General applications are encouraged to use this call sparingly
if at all, and let the system administrator control printer topology updates.
Depending on the print facilities underlying the X Print Server, the X Print Server may be able to detect
changes in the printer topology and dynamically update to reflect the changes, or may not be able to detect
the changes and will have to be notified via
XpRehashPrinterList.
Existing print contexts will not be affected by
XpRehashPrinterList as long as their printer destination remains
valid.
2.2.11 Querying Version, Extension, and Screen
Use
XpQueryVersion to query an X Server to determine if it supports the X Print Service Extension, and if it
does, which version of the X Print Service Extension.
Status XpQueryVersion (display, major_version_return, minor_version_return)
Display *display;
short *major_version_return;
short *minor_version_return;
display
Specifies a pointer to the Display structure; returned from XOpenDisplay.
major_version_return
Returns the major version if the X Print Service Extension exists, else zero.
minor_version_return
Returns the minor version if the X Print Service Extension exists, else zero.
XpQueryVersion determines if the X Print Service Extension is present. A non-zero Status is returned if the
extension is supported, otherwise a zero Status is returned. If the extension is supported, the major and
minor version numbers are returned to indicate the level of X Print Service Extension support.
The X Print Service Extension is initialized on the first call to any X Print Service function; there is no need
to explicitly initialize the X Print Service Extension.
Use
XpQueryExtension to query an X Server to determine if it supports the X Print Service Extension, and if it
does, what the offsets are for associated events and errors.
Bool XpQueryExtension (display, event_base_return, error_base_return)
Display *display;
int *event_base_return;
int *error_base_return;
display
Specifies a pointer to the Display structure; returned from XOpenDisplay.
event_base_return
The base value for X Print Service Extension events.
error_base_return
The base value for X Print Service Extension errors.
XpQueryExtension determines if the X Print Service Extension is present. It returns True if the extension is
supported, otherwise
False. If the extension is present, the base values for events and errors are returned, and
can be used to decode incoming event and error values.
The X Print Service Extension is initialized on the first call to any X Print Service function; there is no need
to explicitly initialize the X Print Service Extension.