Functional specification
23
CDE/Motif PST
CDEnext
2.5.2
Long Description
NAME
XpDestroyContext - unset and destroy a print context.
SYNOPSIS
#include <X11/extensions/Print.h>
void XpDestroyContext(
Display
*display,
XPContext
print_context
)
ARGUMENTS
display
Specifies a pointer to the
Display
structure; returned from
XOpenDisplay
.
print_context
A pre-existing print context.
RETURN VALUE
None.
DESCRIPTION
XpDestroyContext
closes any outstanding associations between the print context and any display
connections, and then destroys the print context to reclaim memory. All display connections using the
print context will no longer be able to access the print context or re-set it (i.e.
XpSetContext
) in the
future.
Since all X Print calls act upon a print context, prematurely destroying a print context will cause in-
progress pages, documents and jobs to be canceled within the X Print Server.
ERRORS/WARNINGS
This function can generate one of the following errors:
XPBadContext
The specified print context id is not valid.
SEE ALSO
XpCreateContext
2.6
XpGetScreenOfContext
2.6.1
Short Description
Get the screen associated with the specified print context.