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) ，如果函式呼叫是使用無效的 HANDLE 進行，或是在進行函式呼叫之前移除裝置物件。

PRINTER_INFO_2 結構是 UpdatePrintDeviceObject 可以更新的屬性類型良好範例。