PRINT_OTHER_INFO 结构 (lmalert.h)

项目
08/24/2023

PRINT_OTHER_INFO 结构包含有关打印作业的信息。 NetAlertRaise 和 NetAlertRaiseEx 函数使用 PRINT_OTHER_INFO 结构指定作业完成打印或打印机需要干预时的信息。

语法

typedef struct _PRINT_OTHER_INFO {
  DWORD alrtpr_jobid;
  DWORD alrtpr_status;
  DWORD alrtpr_submitted;
  DWORD alrtpr_size;
} PRINT_OTHER_INFO, *PPRINT_OTHER_INFO, *LPPRINT_OTHER_INFO;

成员

alrtpr_jobid

类型：DWORD

打印作业的标识号。

alrtpr_status

类型：DWORD

描述打印作业状态的位掩码。

可以通过检查PRJOB_QSTATUS (位 0 和 1) 来获取作业的总体状态。

Lmalert.h 头文件中列出了打印作业状态的可能值。

值	含义
PRJOB_QS_QUEUED 0	打印作业在等待计划队列中。
PRJOB_QS_PAUSED 1	打印作业在队列中，但已暂停。 (作业暂停时，无法计划作业。)
PRJOB_QS_SPOOLING 2	打印作业正在进行后台打印。
PRJOB_QS_PRINTING 3	作业当前正在打印。

如果打印作业处于PRJOB_QS_PRINTING状态，则可以将设备状态 (PRJOB_DEVSTATUS) 检查位 2 到 8。位 15 也有意义。

Lmalert.h 头文件中列出了设备状态的可能值。

值	含义
PRJOB_COMPLETE 0x4	作业已完成打印。
PRJOB_INTERV 0x8	目标打印机需要操作员的干预。
PRJOB_ERROR 0x10	目标打印机出现错误。
PRJOB_DESTOFFLINE 0x20	目标打印机处于脱机状态。
PRJOB_DESTPAUSED 0x40	目标打印机已暂停。
PRJOB_NOTIFY 0x80	应引发打印警报。
PRJOB_DESTNOPAPER 0x100	目标打印机没有纸张。
PRJOB_DELETED 0x8000	正在删除打印作业。

alrtpr_submitted

类型：DWORD

提交打印作业的时间。此值存储为自 1970 年 1 月 1 日 GMT 00：00：00 以来经过的秒数。

alrtpr_size

类型：DWORD

打印作业的大小（以字节为单位）。

注解

其他可变长度数据遵循警报消息缓冲区中的 PRINT_OTHER_INFO 结构。信息采用连续 null 结尾的字符串形式，如下所示。

String	含义
computername	提交打印作业的计算机。
username	提交打印作业的用户。
queuename	作业提交到的打印队列。
destination	打印机目标 (将打印作业路由到的设备) 。
status	打印作业的状态。

调用应用程序必须为警报消息缓冲区中的所有结构和可变长度数据分配和释放内存。

有关演示如何引发打印警报的代码示例，请参阅 NetAlertRaiseEx 。

要求

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