勇芳软件工作室.汉化:  Printing > Print Spooler API > Print Spooler API Reference > Print Spooler API Functions >

DeletePrinter

Previous pageReturn to chapter overviewNext page

描述

 

DeletePrinter功能删除指定的打印机对象。

 

C++ 语法

 

BOOL DeletePrinter(

__in HANDLE hPrinter

);

 

PowerBASIC 语法

 

FUNCTION DeletePrinter ( _

BYVAL hPrinter AS DWORD _

) AS LONG

 

参数

 

hPrinter

 

[in]处理将被删除的打印机对象。使用OpenPrinterAddPrinter功能来检索打印机手柄。

 

返回值

 

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

 

如果函数失败,返回值为零。

 

备注

 

如果指定的打印机还有待处理的打印作业,DeletePrinter将打印机标记为待删除,然后在打印所有打印作业时将其删除。没有打印作业可以添加到标记为待删除的打印机。

 

标记为待删除的打印机无法保留,但其打印作业可以保持,恢复并重新启动。如果打印机保持并且打印机有作业,则DeletePrinter将失败,并显示ERROR_ACCESS_DENIED。

 

请注意,DeletePrinter不会关闭传递给它的句柄。因此,应用程序仍然必须调用ClosePrinter.

 

引用文件 #INCLUDE Once

 

WinSpool.inc(包括Windows.inc)