Platform SDK: Windows GDI

DeletePrinter

DeletePrinter函数删除指定的打印机对象。

BOOL DeletePrinter(
  HANDLE hPrinter   // 打印机对象句柄
);

参数

  • hPrinter

  • [in/out] 将被删除的打印机对象句柄。 使用OpenPrinter或AddPrinter函数检索打印机句柄。

返回值

如果函数成功,则返回值是非零值。

如果函数失败,返回值为零。 要获得扩展的错误信息,请调用GetLastError。

备注

如果指定打印机上剩余的打印作业需要处理,DeletePrinter会将打印机标记为暂挂删除,然后在打印完所有打印作业后将其删除。 没有打印作业可以添加到标记为待处理删除的打印机。

标记为等待删除的打印机无法保持,但其打印作业可以保持,恢复和重新启动。 如果打印机处于暂停状态且打印机有作业,则DeletePrinter将失败,并显示InvalidState错误。

要求

  Windows NT/2000/XP: 包含在Windows NT 3.51和更高版本中。

  Windows 95/98/Me: 不支持。

  头文件: 声明于 Winspool.h; 包含于 Windows.h.
  Library: 使用 Winspool.lib.