JOB _ INFO _ 2 结构

JOB _ INFO _ 2 结构描述与作业关联的一组完整值。

语法

typedef struct _JOB_INFO_2 {
  DWORD                JobId;
  LPTSTR               pPrinterName;
  LPTSTR               pMachineName;
  LPTSTR               pUserName;
  LPTSTR               pDocument;
  LPTSTR               pNotifyName;
  LPTSTR               pDatatype;
  LPTSTR               pPrintProcessor;
  LPTSTR               pParameters;
  LPTSTR               pDriverName;
  LPDEVMODE            pDevMode;
  LPTSTR               pStatus;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Status;
  DWORD                Priority;
  DWORD                Position;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                TotalPages;
  DWORD                Size;
  SYSTEMTIME           Submitted;
  DWORD                Time;
  DWORD                PagesPrinted;
} JOB_INFO_2, *PJOB_INFO_2;

成员

JobId

作业标识符值。

pPrinterName

指向以 null 结尾的字符串的指针,该字符串指定要后台处理作业的打印机的名称。

pMachineName

指向以 null 结尾的字符串的指针,该字符串指定创建打印作业计算机的名称。

pUserName

指向以 null 结尾的字符串的指针,该字符串指定拥有打印作业的用户的名称。

pDocument

指向以 null 结尾的字符串的指针,该字符串指定打印作业的名称 (例如"MS-WORD: Review.doc") 。

pNotifyName

指向以 null 结尾的字符串的指针,该字符串指定打印作业或打印作业时发生错误时应收到通知的用户的名称。

pDatatype

指向以 null 结尾的字符串的指针,该字符串指定用于记录打印作业的数据类型。

pPrintProcessor

指向以 null 结尾的字符串的指针,该字符串指定应用于打印作业的打印处理器的名称。

pParameters

指向以 null 结尾的字符串的指针,该字符串指定打印处理器参数。

pDriverName

指向以 null 结尾的字符串的指针,该字符串指定应用于处理打印作业的打印机驱动程序的名称。

pDevMode

指向 DEVMODE 结构的指针,该结构包含打印机驱动程序的设备初始化和环境数据。

pStatus

指向以 null 结尾的字符串的指针,该字符串指定打印作业的状态。 应在 Status 之前检查此成员,如果 pStatusNULL, 则状态由 Status 成员的内容定义。

pSecurityDescriptor

此成员的值为 NULL。 此版本不支持检索和设置文档安全描述符。

Status

作业状态。 此成员可以是以下一个或多个值。

含义
作业 _ 状态 _ 已阻止 _ DEVQ 驱动程序无法打印作业。
作业 _ _ 状态已删除 作业已删除。
作业 _ _ 状态删除 正在删除作业。
作业 _ 状态 _ 错误 错误与作业关联。
作业 _ 状态 _ 脱机 打印机处于脱机状态。
作业 _ 状态 _ 打印 打印机无纸。
作业 _ _ 状态已暂停 作业已暂停。
打印 _ 的 _ 作业状态 作业已打印。
作业 _ 状态 _ 打印 作业正在打印。
作业 _ 状态 _ 重启 作业已重启。
作业 _ _ 状态后台处理 作业正在后台处理。
作业 _ 状态 _ 用户 _ 干预 打印机出现错误,要求用户执行某些操作。

在 Windows XP 及更高版本的 Windows 中,还可使用以下值:

含义
作业 _ 状态 _ 完成 作业将发送到打印机,但可能尚未打印。 有关更多信息,请参见备注。
作业 _ _ 状态已保留 打印后,作业已保留在打印队列中。

Priority

作业优先级。 此成员可以是以下值之一,也可以介于 1 到 99 之间 (最小优先级到 _ MAX _ PRIORITY) 。

含义
最小 _ 优先级 最小优先级。
最大 _ 优先级 最大优先级。
DEF _ 优先级 默认优先级。

位置

作业在打印队列中的位置。

StartTime

可以打印作业的最早时间。

UntilTime

打印作业的最近时间。

TotalPages

作业所需的页数。 如果打印作业不包含页分隔信息,则此值可能为零。

大小

作业的大小(以字节为单位)。

已提交

个 SYSTEMTIME 结构,指定提交作业的时间。

此时间值采用通用时间坐标 (UTC) 格式。 在显示之前,应将其转换为本地时间值。 可以使用 FileTimeToLocalFileTime 函数执行转换。

时间

作业开始打印后已用的总时间(以毫秒为单位)。

PagesPrinted

已打印的页数。 如果打印作业不包含页分隔信息,此值可能为零。

备注

不支持 TrueEndOfJob 的端口监视器会将作业设置为作业状态,然后将作业 _ _ 提交到打印机。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
winspool.drv (包括 Windows .h)
Unicode 和 ANSI 名称
_ 作业 _ 信息 _ 2w (Unicode) 和 _ 作业 _ 信息 _ 2a (ANSI)

请参阅

打印

打印后台处理程序 API 结构

DEVMODE

EnumJobs

GetJob

SetJob