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) |
库 | Nwprint.lib |