AbortProc

The AbortProc function is an application-defined callback function used with the SetAbortProc function. It is called when a print job is to be canceled during spooling. The ABORTPROC type defines a ointer to this callback function. AbortProc is a placeholder for the application-defined function name.

BOOL CALLBACK AbortProc(
  HDC hdc,     // handle to device context
  int iError   // error value
);
 

Parameters

hdc
Handle to 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 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

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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: User-defined.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Functions, GetMessage, PeekMessage, SetAbortProc