ControlPrintProcessor 函数 (winsplp.h)

  • 项目

打印处理器的 ControlPrintProcessor 函数允许后台处理程序控制打印作业。

语法

BOOL ControlPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] DWORD  Command
);

参数

[in] hPrintProcessor

调用方提供的打印处理器句柄。 这是以前调用 OpenPrintProcessor 返回的句柄。

[in] Command

调用方提供的命令，指示要执行的操作类型。 以下命令有效：

命令 定义
JOB_CONTROL_CANCEL 函数应取消当前打印作业。
JOB_CONTROL_PAUSE 函数应暂停当前打印作业。
JOB_CONTROL_RESUME 函数应恢复当前打印作业。

返回值

如果操作成功，函数应返回 TRUE。 如果操作失败，函数应调用 SetLastError 来设置错误代码，然后返回 FALSE。

注解

导出 ControlPrintProcessor 函数需要打印处理器。 当应用程序调用 SetJob 函数时，后台处理程序会调用函数，如Microsoft Windows SDK文档中所述。

根据收到的 Command 值，函数应暂停、恢复或取消当前作业。 可在打印处理器的 PrintDocumentOnPrintProcessor 函数执行时异步调用 ControlPrintProcessor 函数。 因此，必须采用某种同步技术，例如设置内部定义的事件对象以暂停作业并在恢复作业时重置事件对象。 ControlPrintProcessor 函数可以在设置或重置事件对象后快速返回，PrintDocumentOnPrintProcessor 可以等待事件处于正确的状态。

要求

要求 值
目标平台 桌面
标头 winsplp.h (包括 Winsplp.h)
Library Nwprint.lib

另请参阅

OpenPrintProcessor

PrintDocumentOnPrintProcessor