AbortPrinter

The AbortPrinter function deletes a printer's spool file if the printer is configured for spooling.

BOOL AbortPrinter(
  HANDLE hPrinter   // handle to printer object
);
 

Parameters

hPrinter

Handle to the printer from which the spool file is deleted.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

If the printer is not configured for spooling, the AbortPrinter function has no effect.

The printer handle identified by the hPrinter parameter is returned by the OpenPrinter 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: Use winspool.lib.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Functions, OpenPrinter