EngCheckAbort function (winddi.h)

The EngCheckAbort function enables a printer graphics DLL to determine if a print job should be terminated.

Syntax

ENGAPI BOOL EngCheckAbort(
  SURFOBJ *pso
);

Parameters

pso

Caller-supplied pointer to a SURFOBJ structure, previously received from GDI.

Return value

If the print job should be terminated, the function returns TRUE. If the print job should not be terminated, or if pso does not point to a valid SURFOBJ structure, the function returns FALSE.

Remarks

A printer graphics DLL should call EngCheckAbort from within any graphics DDI function that takes more than five seconds to execute. If the print job should be terminated, the printer graphics DLL should stop its current operation and return to GDI, specifying a return value of FALSE for the graphics DDI function that called EngCheckAbort.

Requirements

Requirement Value
Minimum supported client Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform Universal
Header winddi.h (include Winddi.h)
Library Win32k.lib
DLL Win32k.sys