共用方式為


OpenPrintProcessor 函式 (winsplp.h)

列印處理器的 OpenPrintProcessor 函式會準備列印處理器以列印作業並傳回句柄。

語法

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

參數

[in] pPrinterName

呼叫端提供的指標,指向正在開啟列印處理器的印表機名稱。

[in] pPrintProcessorOpenData

PRINTPROCESSOROPENDATA 結構的呼叫端提供的指標。

傳回值

如果作業成功,函式應該會傳回句柄,這個句柄可以做為輸入自變數,以便後續呼叫 printDocumentOnPrintProcessorControlPrintProcessor,以及 ClosePrintProcessor。 如果作業失敗,函式應該呼叫 SetLastError 來設定錯誤碼,然後傳回 NULL

言論

需要列印處理器才能匯出 OpenPrintProcessor 函式。 當列印作業可用時,多任務緩衝處理程式會呼叫 函式。 函式應該根據作業的數據類型,執行作業處理之前所需的初始化作業。

函式必須傳回句柄。 一般而言,句柄是內部結構的指標。 結構必須包含印表機名稱的指標,以及印表機 DEVMODEW 結構的指標,這兩者都是在 PRINTPROCESSOROPENDATA 結構 中接收的。 列印處理器的 PrintDocumentOnPrintProcessor 函式需要這兩個指標,而後一個函式會在多任務緩衝處理器呼叫它時接收作為輸入的句柄。

要求

要求 價值
目標平臺 桌面
標頭 winsplp.h (包括 Winsplp.h)
連結庫 Nwprint.lib

另請參閱

ClosePrintProcessor

ControlPrintProcessor

PRINTPROCESSOROPENDATA

PrintDocumentOnPrintProcessor