AbortProc
The AbortProc
function is an application-defined callback function that is called when a
print job is to be canceled during spooling.
BOOL CALLBACK AbortProc(
HDC hdc, |
// handle to device
context |
int iError |
// error value |
); |
|
Parameters
hdc
Identifies
the device context for the print job.
iError
Specifies
whether an error has occurred. This parameter is zero if no error has occurred;
it is SP_OUTOFDISK if Windows Print Manager is currently out of disk space and
more disk space will become available if the application waits.
Return Values
The callback
function should return TRUE to continue the print job or FALSE to cancel the
print job.
Remarks
An application
installs this callback function by calling the SetAbortProc function.
The AbortProc function is a placeholder for the application-defined function
name.
If the iError
parameter is SP_OUTOFDISK, the application need not cancel the print job. If it
does not cancel the job, it must yield to Print Manager by calling the PeekMessage
or GetMessage function.
See Also