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 可以更新之屬性類型的良好範例。