AbortProc

3.1

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

The AbortProc function is an application-defined callback function that is called when a print job is to be canceled during spooling.

Parameters

hdc

Identifies the device context.

error

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. If this 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.

Return Value

The callback function should return TRUE to continue the print job or FALSE to cancel the print job.

Comments

An application installs this callback function by calling the SetAbortProc function. AbortProc is a placeholder for the application-defined function name. The actual name must be exported by including it in an EXPORTS statement in the application's module-definition file.

See Also

GetMessage, PeekMessage, SetAbortProc