ScheduleJob 函式

ScheduleJob函式會要求列印多工緩衝處理器排程指定的列印工作以進行列印。

語法

BOOL ScheduleJob(
  _In_ HANDLE hPrinter,
  _In_ DWORD  dwJobID
);

hPrinter [in]

列印工作印表機的控制碼。這必須是設定為多工緩衝印表機的本機印表機。如果 hPrinter 是遠端印表機連線的控制碼，或印表機設定為直接列印， ScheduleJob 函式會失敗。使用 OpenPrinter 或 AddPrinter 函式來擷取印表機控制碼。

hPrinter必須是取得dwJobID列印工作識別碼之AddJob呼叫中指定的相同印表機控制碼。

dwJobID [in]

要排程的列印工作。您可以藉由呼叫 AddJob 函式來取得此列印工作識別碼。

如果函式成功，則傳回值是非零值。

如果此函式失敗，則傳回值為零。

注意

這是封鎖或同步函式，可能不會立即傳回。此函式傳回的速度取決於執行時間因素，例如網路狀態、列印伺服器組態，以及難以在撰寫應用程式時預測的印表機驅動程式實作因素。從管理與使用者介面互動的執行緒呼叫此函式，可能會讓應用程式看起來沒有回應。

您必須先成功呼叫 AddJob 函式，才能呼叫 ScheduleJob 函式。 AddJob會取得您傳遞至 ScheduleJob 做為dwJobID的列印工作識別碼。這兩個呼叫都必須針對 hPrinter使用相同的值。

ScheduleJob函式會檢查有效的多工緩衝處理檔案。如果有不正確多工緩衝處理檔案，或者如果它是空的， ScheduleJob 會刪除多工緩衝處理檔和列印多工緩衝處理器中對應的列印工作專案。