ClosePrinter

The ClosePrinter function closes the specified printer object.

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

Parameters

hPrinter

Handle to the printer object to be closed.

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

When the ClosePrinter function returns, the handle hPrinter is invalid, regardless of whether the function has succeeded or failed.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winspool.h.
  Import Library: Use winspool.lib.

See Also

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