IXpsPrintJob::GetJobStatus 方法 (xpsprint.h)
[IXpsPrintJob::GetJobSatus 不受支援,未來可能會改變或無法使用。 ]
取得列印工作的目前狀態。
語法
HRESULT GetJobStatus(
[out, retval] XPS_JOB_STATUS *jobStatus
);
參數
[out, retval] jobStatus
列印工作的目前狀態。 如需此結構中傳回之資料的相關資訊,請參閱 XPS_JOB_STATUS。
傳回值
如果方法成功,則會傳回S_OK;否則,它會傳回 HRESULT 錯誤碼。
備註
在列印工作處理期間或列印工作完成之後,可以呼叫GetJobStatus。 XPS_JOB_STATUS傳回的值代表呼叫 GetJobStatus時列印工作的目前狀態,因此可以在呼叫此方法時遺漏中繼狀態。
jobStatus.currentDocument和jobStatus.currentPage的值保證會循序進行:從第一份檔到最後一個檔,以及從第一頁到每份檔內的最後一頁。
已傳送至 Microsoft XPS 檔寫入器 (MXDW) 之列印工作的作業識別碼為零。 如果介面是已傳送至 MXDW 的列印工作,則會在 jobStatus.jobId中傳回零。
如果未將作業識別碼指派給列印工作,或列印工作沒有多工緩衝處理,則會在 jobStatus.jobId中傳回零。
規格需求
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | xpsprint.h |