DeletePrinterDriverPackage 函数

从驱动程序存储中删除打印机驱动程序包。

语法

HRESULT DeletePrinterDriverPackage(
  _In_ LPCTSTR pszServer,
  _In_ LPCTSTR pszInfPath,
  _In_ LPCTSTR pszEnvironment
);

pszServer [in]: 指向常量、以 null 结尾的字符串的指针，该字符串指定要从中删除驱动程序包的打印服务器的名称。 NULL 指针值表示本地计算机。
pszInfPath [in]: 指向以 null 结尾的常量字符串的指针，该字符串指定驱动程序的 *.inf 文件的路径。
pszEnvironment [in]: 指向以 null 结尾的常量字符串的指针，该字符串指定处理器体系结构 (例如，Windows NT x86) 。这可以是 NULL。

如果操作成功，S_OK。

如果包是 Windows 附带的，E_ACCESSDENIED。

HRESULT_CODE (ERROR_PRINT_DRIVER_PACKAGE_IN_USE) ，如果正在使用包。

否则， HRESULT 将包含错误代码。

有关 COM 错误代码的详细信息，请参阅错误处理。

注意

这是一个阻塞或同步函数，可能不会立即返回。此函数的返回速度取决于运行时因素，例如网络状态、打印服务器配置以及编写应用程序时难以预测的打印机驱动程序实现因素。从管理与用户界面交互的线程调用此函数可能会使应用程序看起来无响应。

驱动程序存储通常为 %windir%\inf 或 %windir%\System32\DriverStore\FileRepository。

Windows 附带的驱动程序包不能随此函数一起删除。

用户必须具有打印机管理权限。

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Winspool.h (包括 Windows.h)
库	Winspool.lib
DLL	Spoolss.dll
Unicode 和 ANSI 名称	DeletePrinterDriverPackageW (Unicode) 和 DeletePrinterDriverPackageA (ANSI)