UpdatePrintDeviceObject 函数（winsplp.h）

警告

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

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

语法

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

[in] hPrinter

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

[in] hDeviceObject

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

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

例如，如果函数调用的句柄无效，或者在执行函数调用之前删除了设备对象，则此函数可以返回HRESULT_FROM_WIN32（ERROR_INVALID_HANDLE）。

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