RemovePrintDeviceObject 函式 (winsplp.h)

警告

從 Windows 10 開始，支援第三方列印提供者的 API 已被取代。 Microsoft 不建議對第三方列印提供者進行任何投資。此外，在 v4 列印驅動程式模型的 Windows 8 和較新版本產品上，第三方列印提供者可能不會建立或管理使用 v4 列印驅動程式的佇列。

RemovePrintDeviceObject 函式會從列印提供者佇列中移除裝置物件。

語法

HRESULT RemovePrintDeviceObject(
  [in] HANDLE hDeviceObject
);

[in] hDeviceObject

要移除之裝置物件的 HANDLE。這應該是使用 AddPrintDeviceObject 建立的裝置物件。

如果已成功移除裝置物件， RemovePrintDeviceObject 函式會傳回S_OK。否則會傳回錯誤。

例如，如果使用無效的裝置物件句柄來呼叫函式，此函式可以傳回HRESULT_FROM_WIN32 (ERROR_INVALID_HANDLE) 。請注意，無論傳回值為何，裝置物件 HANDLE 在 呼叫 RemovePrintDeviceObject 完成之後會變成無效。

呼叫 RemovePrintDeviceObject 以移除已刪除印表機的裝置物件。當多任務緩衝處理器服務停止時，會自動刪除所有裝置物件，因此不需要為每個印表機裝置物件呼叫 RemovePrintDeviceObject 。