ReportJobProcessingProgress 函数

向打印后台处理程序服务报告 XPS 打印作业是否处于后台打印或呈现阶段，以及正在处理的哪个部分。

语法

HRESULT ReportJobProcessingProgress(
  _In_ HANDLE                printerHandle,
  _In_ ULONG                 jobId,
       EPrintXPSJobOperation jobOperation,
       EPrintXPSJobProgress  jobProgress
);

参数

printerHandle [in]

函数要检索其信息的打印机句柄。 使用 OpenPrinter 或 AddPrinter 函数检索打印机句柄。

jobId [in]

标识要检索数据的打印作业。 使用 AddJob 函数或 StartDoc 函数获取打印作业标识符。

jobOperation

指定作业是处于后台打印阶段还是呈现阶段。

jobProgress

指定当前正在进行的处理部分。 此值引用后台打印或呈现阶段的事件，具体取决于 jobOperation 的值。

返回值

如果操作成功，则返回值为S_OK，否则 HRESULT 将包含错误代码。

有关 COM 错误代码的详细信息，请参阅 错误处理。

备注

注意

这是一个阻塞或同步函数，可能不会立即返回。 此函数的返回速度取决于运行时因素，例如网络状态、打印服务器配置以及编写应用程序时难以预测的打印机驱动程序实现因素。 从管理与用户界面交互的线程调用此函数可能会使应用程序看起来无响应。

注意

ReportJobProcessingProgress 仅当打印作业处于后台打印或呈现阶段时，才会报告 XPS 打印作业的进度。 如果在 XPS 打印作业不在后台打印或呈现阶段时调用 ReportJobProcessingProgress，则将失败。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Winspool.h (包括 Windows.h)
库	Winspool.lib
DLL	Spoolss.dll

另请参阅

打印

打印后台处理程序 API 函数

EPrintXPSJobOperation

EPrintXPSJobProgress