UpdatePrintDeviceObject 函数 (winsplp.h)

  • 项目

警告

从Windows 10开始，支持第三方打印提供程序的 API 已弃用。 Microsoft 不建议对第三方打印提供商进行任何投资。 此外，在提供 v4 打印驱动程序模型的Windows 8和较新的产品上，第三方打印提供程序不得创建或管理使用 v4 打印驱动程序的队列。

UpdatePrintDeviceObject 函数更新打印提供程序队列中的设备对象的属性。

语法

HRESULT UpdatePrintDeviceObject(
  [in] HANDLE hPrinter,
  [in] HANDLE hDeviceObject
);

参数

[in] hPrinter

打开的打印机的句柄。 这应该是 AddPrinter 或 OpenPrinter 后台处理程序函数返回的句柄。

[in] hDeviceObject

要更新的设备对象的 HANDLE。 这应该是使用 AddPrintDeviceObject 创建的设备对象。

返回值

如果成功更新设备对象的属性， UpdatePrintDeviceObject 函数将返回S_OK。 否则它将返回错误。

例如，如果函数调用是使用无效 HANDLE 进行的，或者在执行函数调用之前删除了设备对象，则此函数可以返回HRESULT_FROM_WIN32 (ERROR_INVALID_HANDLE) 。

注解

PRINTER_INFO_2 结构是 UpdatePrintDeviceObject 可以更新的属性类型的一个很好的示例。

要求

要求 值
目标平台 桌面
标头 winsplp.h (包括 Winspool.h)
Library WinSpool.lib
DLL WinSpool.drv

另请参阅

AddPrintDeviceObject

PRINTER_INFO_2