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

分配给打印作业的后台处理程序作业 ID。 如果尚未分配作业 ID, 则 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 纸张规范

XPS_JOB_COMPLETION