ScheduleJob 函数

ScheduleJob 函数请求打印后台处理程序计划指定的打印作业进行打印。

语法

BOOL ScheduleJob(
  _In_ HANDLE hPrinter,
  _In_ DWORD  dwJobID
);

hPrinter [in]

打印作业打印机的句柄。这必须是配置为后台打印打印机的本地打印机。如果 hPrinter 是远程打印机连接的句柄，或者打印机配置为直接打印， 则 ScheduleJob 函数将失败。使用 OpenPrinter 或 AddPrinter 函数检索打印机句柄。

hPrinter 必须是在调用 AddJob 时指定的、获取 dwJobID 打印作业标识符的打印机句柄。

dwJobID [in]

要计划的打印作业。通过调用 AddJob 函数获取此打印作业标识符。

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

注意

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

在调用 ScheduleJob 函数之前，必须成功调用 AddJob 函数。 AddJob 获取作为 dwJobID 传递给 ScheduleJob 的打印作业标识符。两个调用必须为 hPrinter 使用相同的值。

ScheduleJob 函数检查是否有有效的后台打印文件。如果后台打印文件无效，或者如果文件为空， 则 ScheduleJob 将删除后台处理程序中的后台打印文件和相应的打印作业条目。

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