ControlPrintProcessor 函式 (winsplp.h)

  • 發行項

列印處理器的 ControlPrintProcessor 函式可讓多任務緩衝處理器控制列印作業。

語法

BOOL ControlPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] DWORD  Command
);

參數

[in] hPrintProcessor

呼叫端提供的列印處理器句柄。 這是先前呼叫 OpenPrintProcessor 所傳回的句柄。

[in] Command

呼叫端提供的命令，指出要執行的作業類型。 下列命令有效：

命令 定義
JOB_CONTROL_CANCEL 函式應該取消目前的列印作業。
JOB_CONTROL_PAUSE 函式應該暫停目前的列印作業。
JOB_CONTROL_RESUME 函式應該會繼續目前的列印作業。

傳回值

如果作業成功，函式應該會傳回 TRUE。 如果作業失敗，函式應該呼叫 SetLastError 來設定錯誤碼，然後傳回 FALSE。

備註

需要列印處理器才能匯出 ControlPrintProcessor 函式。 當應用程式呼叫 SetJob 函式時，多任務緩衝處理程式會呼叫函式，如 Microsoft Windows SDK 檔中所述。

根據 Command 收到的值，函式應該暫停、繼續或取消目前的作業。 當列印處理器的 PrintDocumentOnPrintProcessor 函式正在執行時，可以異步呼叫 ControlPrintProcessor 函式。 因此必須採用某種同步處理技術，例如設定內部定義的事件對象以暫停作業，並在作業繼續時重設事件物件。 ControlPrintProcessor 函式可以在設定或重設事件對象之後快速傳回，PrintDocumentOnPrintProcessor 可以等候事件處於適當的狀態。

規格需求

需求 值
目標平台 桌面
標頭 winsplp.h (包含 Winsplp.h)
程式庫 Nwprint.lib

另請參閱

OpenPrintProcessor

PrintDocumentOnPrintProcessor