XpCancelJob(3Xp)	       XPRINT FUNCTIONS 	      XpCancelJob(3Xp)



NAME
       XpCancelJob -  Cancels a single print job.

SYNOPSIS
	     cc [ flag... ] file... -lXp [ library... ]
	     #include <X11/extensions/Print.h>

       void XpCancelJob ( display, discard )

	     Display *display;
	     Bool discard;


ARGUMENTS
       display
	      Specifies  a  pointer  to  the  Display structure; returned from
	      XOpenDisplay.

       discard
	      When TRUE, specifies that all  XPPrintNotify  events  should  be
	      discarded.

DESCRIPTION
       XpCancelJob  cancels  an  in-progress  job. If the job was started with
       output_mode XPGetData then the data stream to XpGetDocumentData is ter-
       minated. For many page description languages such arbitrary termination
       may invalidate the output.

       If the job was started with output_mode XPSpool then depending  on  the
       driver  and  spooler  configuration the entire job may be canceled or a
       partial job may be generated.

       If discard is TRUE, all XPPrintNotify events with  a  detail  field  of
       XPEndPageNotify, XPEndDocNotify, or XPEndJobNotify are discarded before
       XpCancelJob returns.

       For  clients  selecting	XPPrintMask  (see  XpSelectInput),  the  event
       XPPrintNotify  will be generated with its detail field set to XPEndJob-
       Notify.

DIAGNOSTICS
       XPBadContext   A valid print context-id has not been set prior to  mak-
		      ing this call.

       XPBadSequence  The  function  was  not  called in the proper order with
		      respect to the other X  Print  Service  Extension  calls
		      (for example, XpEndJob prior to XpStartJob).

SEE ALSO
       XpEndJob(3Xp),	     XpGetDocumentData(3Xp),	   XpSelectInput(3Xp),
       XpStartJob(3Xp)




X Version 11			  libXp 1.0.0		      XpCancelJob(3Xp)

NAME - SYNOPSIS - ARGUMENTS - DESCRIPTION - DIAGNOSTICS - SEE ALSO -