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 为零。 如果接口是已发送到 MXDW 的打印作业的接口,则 jobStatus.jobId 中将返回零。
如果尚未将作业 ID 分配给打印作业,或者打印作业时没有后台打印,则 jobStatus.jobId 中将返回零。
要求
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | xpsprint.h |
请参阅
文档