ReportJobProcessingProgress 函式

列印多工緩衝處理服務報告 XPS 列印工作是否在多工緩衝處理或轉譯階段，以及目前正在處理的部分。

語法

HRESULT ReportJobProcessingProgress(
  _In_ HANDLE                printerHandle,
  _In_ ULONG                 jobId,
       EPrintXPSJobOperation jobOperation,
       EPrintXPSJobProgress  jobProgress
);

參數

printerHandle [in]

函式用來擷取資訊的印表機控制碼。 使用 OpenPrinter 或 AddPrinter 函式來擷取印表機控制碼。

jobId [in]

識別要擷取資料的列印工作。 使用 AddJob 函式或 StartDoc 函式來取得列印工作識別碼。

jobOperation

指定作業是在多工緩衝處理階段還是轉譯階段。

jobProgress

指定目前正在處理的部分。 此值是指多工緩衝處理或轉譯階段中的事件，視 jobOperation的值而定。

傳回值

如果作業成功，傳回值會S_OK，否則 HRESULT 會包含錯誤碼。

如需 COM 錯誤碼的詳細資訊，請參閱 錯誤處理。

備註

注意

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

注意

如果列印工作位於多工緩衝處理或轉譯階段，ReportJobProcessingProgress只會報告 XPS 列印工作的進度。 當 XPS 列印工作不在多工緩衝處理或轉譯階段時，ReportJobProcessingProgress將會失敗。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	Winspool.h (包含 Windows.h)
程式庫	Winspool.lib
DLL	Spoolss.dll

另請參閱

列印

列印多工緩衝處理器 API 函式

EPrintXPSJobOperation

EPrintXPSJobProgress