共用方式為


XPS_JOB_STATUS結構 (xpsprint.h)

[XPS_JOB_STATUS 不受支援,未來可能會變更或無法使用。 ]

包含作業狀態的快照集。

語法

typedef struct __MIDL___MIDL_itf_xpsprint_0000_0000_0002 {
  UINT32             jobId;
  INT32              currentDocument;
  INT32              currentPage;
  INT32              currentPageTotal;
  XPS_JOB_COMPLETION completion;
  HRESULT            jobStatus;
} XPS_JOB_STATUS;

成員

jobId

指派給列印工作的多工緩衝處理常式工作識別碼。 如果尚未指派任何作業識別碼, jobId 將會是 0。

currentDocument

列印工作中最近處理檔之以零起始的索引;0 是第一份檔,1 是下一份檔,依此類移。 如果尚未處理任何檔, currentDocument 的值會是 -1。

currentPage

目前檔中最近處理頁面之以零起始的索引;0 是第一頁,1 是下一頁,依此類移。 如果未處理任何頁面, currentPage 的值會是 -1。

currentPageTotal

列印工作已處理的頁數總計。 在作業開始時,此值為 0。 由於每個檔中的每個頁面都由工作處理,因此此值會以單純的方式增加。

completion

指出作業完成狀態 的 XPS_JOB_COMPLETION 值。 當StartXpsPrintJobcompletionEvent參數中傳遞的事件在作業結束時發出訊號時,這個值將會變更。 如果列印工作失敗,此值將會 XPS_JOB_FAILED,其中 jobStatus 包含失敗的錯誤碼。

jobStatus

作業的錯誤狀態。 如果作業完成但未發生錯誤,此值將會 S_OK。 如果錯誤導致列印工作結束,這個值將會是失敗的錯誤碼。

規格需求

   
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
標頭 xpsprint.h

另請參閱

文件

IXpsPrintJob::GetJobStatus

XML Paper Specification

XPS_JOB_COMPLETION