IXpsPrintJob::GetJobStatus 方法 (xpsprint.h)

[IXpsPrintJob::GetJobSatus 不受支持,将来可能会更改或不可用。 ]

获取打印作业的当前状态。

语法

HRESULT GetJobStatus(
  [out, retval] XPS_JOB_STATUS *jobStatus
);

参数

[out, retval] jobStatus

打印作业的当前状态。 有关此结构中返回的数据的信息,请参阅 XPS_JOB_STATUS

返回值

如果该方法成功,则返回S_OK;否则,它将返回 HRESULT 错误代码。

注解

可以在打印作业处理期间或打印作业完成后调用 GetJobStatusXPS_JOB_STATUS中返回的值表示调用 GetJobStatus 时打印作业的当前状态,因此在调用此方法之间可能会错过中间状态。

jobStatus.currentDocumentjobStatus.currentPage 的值保证按顺序进行:从第一个文档到最后一个文档,从第一页到每个文档中的最后一页。

已发送到 Microsoft XPS 文档编写器 (MXDW) 的打印作业的作业 ID 为零。 如果接口是已发送到 MXDW 的打印作业的接口,则 jobStatus.jobId 中将返回零。

如果尚未将作业 ID 分配给打印作业,或者打印作业时没有后台打印,则 jobStatus.jobId 中将返回零。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 xpsprint.h

请参阅

文档

IXpsPrintJob

XML 纸张规范

XPS_JOB_COMPLETION

XPS_JOB_STATUS