AddPrintDeviceObject 函式 (winsplp.h)

警告

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

AddPrintDeviceObject 列印提供者函式會建立列印提供者佇列的裝置物件。

語法

HRESULT AddPrintDeviceObject(
  [in]  HANDLE hPrinter,
  [out] HANDLE *phDeviceObject
);

[in] hPrinter

開啟印表機的句柄。這應該是 AddPrinter 或 OpenPrinter 多任務緩衝處理程式函式所傳回的 HANDLE。

[out] phDeviceObject

如果已成功建立裝置物件的 HANDLE 則為。

如果已成功建立裝置物件， AddPrintDeviceObject 函式會傳回S_OK。否則，它會傳回錯誤。

在下列情況下，應該呼叫 AddPrintDeviceObject 函式：

印表提供者應該針對提供者擁有的每個先前安裝的印表機呼叫此函式。在此期間， AddPrintDeviceObject 不需要在呼叫時模擬用戶內容。

使用 AddPrintDeviceObject 新增的任何裝置物件都會保存，直到您使用 RemovePrintDeviceObject 移除，或直到多任務緩衝處理程式服務重新啟動為止。當多任務緩衝處理程式服務停止時，會自動刪除所有裝置物件。