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 移除它,或直到多任務緩衝處理程式服務重新啟動為止。 當多任務緩衝處理程式服務停止時,系統會自動刪除所有裝置物件。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | winsplp.h (包括 Winspool.h) |
連結庫 | WinSpool.lib |
DLL | WinSpool.drv |