打印系统开发(66)——监控打印机的打印队列

问：

如何监控打印机的打印队列，可以获得正在打印文档的文档名，状态，所有者，页数，大小等。

答：

1、C++代码

一、API介绍：

API是Application Programming Interface的缩写，也就是应用程序调用系统功能的接口。Windows API主要包括系统定义的函数、消息及与之相关的数据类型。我们使用各种开发工具归根结底都是和API打交道。

二、与打印状态相关的API：

Api函数名 函数说明 W3.x W9x NT 
EnumJobs 获取打印作业信息 否 是 是 
OpenPrinter 获取指定打印机的句柄 否 是 是 


在 Windows NT 版本以及 Windows 9x 中，增加了一批全新的、专门用来处理打印机及打印机队列状态的 API 函数。在这里，将通过 API 函数 OpenPrinter 与 EnumJobs，来确定打印机打印作业状态所需的信息。

OpenPrinter，用来获取给定打印机的句柄，通过该句柄可以实现对相应打印机的操作。

函数 EnumJobs，用来列出所指定打印机上正在打印的作业信息，这里给定打印机的引用就是通过使用上述OpenPrinter函数反馈回来的打印机句柄。


EnumJobs函数介绍：

EnumJobs (ByVal hPrinter As Long, ByVal FirstJob As Long, ByVal NoJobs As Long, ByVal Level As Long, pJob As Long, ByVal cbBuf As Long, pcbNeeded As Long, pcReturned As Long) 

API函数EnumJobs用于列举给定打印机当前所有正在打印的任务状态信息，该函数可以列举给定打印机简要的或者详细的（Level决定）队列任务状态信息。在引用该函数时，通常先把cbBuf变量设置为0，以获得打印机队列任务的字节数，该字节数存储在pcbNeeded里以决定pJob变量大小，然后再次引用该函数，获得打印机队列任务的详细信息。

参数：

hPrinter
打印机句柄。

FirstJob
统计打印机队列任务数的起始点，0表示从第一个任务开始统计列举所有的打印任务。

NoJobs
需要列举的最大打印任务数。一般设为127。

Level
标示存储在pJob里的信息格式。如果该值为1，数据以JOB_INFO_1的格式存储；如果该值为2，数据以JOB_INFO_2的格式存储。

pJob
数组变量，保存打印任务的所有信息；cbBuf设为0时，该值也为0。Level变量的值决定pJob的数据格式（JOB_INFO_1 OR JOB_INFO_2）

cbBuf
该值通常为0。

pcbNeeded
存储打印机里打印任务的字节数。

pcReturned
用来存放打印任务数量的变量。

通过上表可以看出，这两个API函数只用使用在Windows 9x 以及 Windows NT环境中。

三、开发工具：

C++ Builder作为快速开发Windows平台下应用程序的工具，已经为越来越多的开发者采用。但是，如果要开发出专业的Windows应用软件，还需要使用大量的Windows API函数，以下是笔者应用C++ Builder以及Windows API函数来实现对打印机状态的时时监控。

选择C++ Builder的理由：

一：由于Windows API 都是用C或C++编写的，C++ Builder更易于底层应用。

二：C++ Builder对于Windows API的引用更加简单，这一点是Visual Basic所欠缺的。


四、程序实例：
1、启动C++ Builder程序，新创建一个工程；

2、进入工程，在当前窗体分别添加一个CheckListBox控件、一个Timer控件；

3、在CheckListBox控件的Item属性添加打印机名称列表（假设在网络中HostPrinter主机上有三台打印机Printer1、Printer2、Printer3），则Item项目里内容格式为：\\HostPrinter\Printer1、\\HostPrinter\\Printer2、\\HostPrinter\\Printer3 ；

4、Timer的Interval属性设置为60000（一分钟），在Timer的OnTimer事件加入如下代码：

{
HANDLE hPrinter; //打印机句柄
JOB_INFO_2 jobs[30]; /