Windows 3.1 Device Drivers (ddag31qh.hlp) (Table of Contents; Topic list)
SETABORTPROC
                                                     Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define SETABORTPROC 9 
short Control(lpDevice, SETABORTPROC, lphDC, NULL)
LPPDEVICE lpDevice;
LPHANDLE lphDC;
 
The SETABORTPROC escape sets the cancel function for the print job.
 
If an application wants to allow the print job to be cancelled during
spooling, it must set the cancel function before the print job is started
with the STARTDOC escape. Print Manager calls the cancel function during
spooling to allow the application to cancel the print job or to handle
out-of-disk-space conditions. If no cancel function is set, the print job
will fail if there is not enough disk space for spooling.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
 
lpDevice   Points to a PDEVICE structure specifying the destination device.
 
lphDC      Points to a handle to the application's device context for the
           print job.
 
Return Value
 
The return value is positive if the escape is successful. Otherwise, it is
negative.
 
Comments
 
The driver should pass the application's device context handle to the
OpenJob (GDI.240) function to allow GDI to call the application's callback
function.
 
See Also
 
STARTDOC, PDEVICE
 
 
                                      ♦