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) に送信された印刷ジョブのジョブ ID は 0 です。 インターフェイスが MXDW に送信された印刷ジョブのインターフェイスの場合は、 jobStatus.jobId で 0 が返されます。

印刷ジョブにジョブ ID が割り当てられていない場合、または印刷ジョブがスプールなしで印刷される場合は、 jobStatus.jobId にゼロが返されます。

要件

サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	xpsprint.h

関連項目

ドキュメント

IXpsPrintJob

XML Paper Specification

XPS_JOB_COMPLETION

XPS_JOB_STATUS