SETABORTPROC

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.

Parameters

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