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 终止字符串的指针。 应在 状态 之前检查此成员,如果 pStatusNULL,状态由状态成员的内容定义。

pSecurityDescriptor

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

Status

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

含义
JOB_STATUS_BLOCKED_DEVQ 驱动程序无法打印作业。
JOB_STATUS_DELETED 作业已被删除。
JOB_STATUS_DELETING 正在删除作业。
JOB_STATUS_ERROR 错误与作业相关联。
JOB_STATUS_OFFLINE 打印机处于脱机状态。
JOB_STATUS_PAPEROUT 打印机已出纸。
JOB_STATUS_PAUSED 作业已暂停。
JOB_STATUS_PRINTED 作业已打印。
JOB_STATUS_PRINTING 作业正在打印。
JOB_STATUS_RESTART 作业已重启。
JOB_STATUS_SPOOLING 作业正在后台处理。
JOB_STATUS_USER_INTERVENTION 打印机有一个错误,要求用户执行某些操作。

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

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

Priority

作业优先级。 此成员可以是以下值之一,也可以介于 1 到 99 (MIN_PRIORITY 到 MAX_PRIORITY) 之间。

含义
MIN_PRIORITY 最低优先级。
MAX_PRIORITY 最大优先级。
DEF_PRIORITY 默认优先级。

位置

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

StartTime

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

UntilTime

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

TotalPages

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

大小

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

已提交

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

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

时间

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

PagesPrinted

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

备注

不支持 TrueEndOfJob 的端口监视器将在作业提交到打印机后立即将作业设置为JOB_STATUS_PRINTED。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Winspool.h (包括 Windows.h)
Unicode 和 ANSI 名称
_JOB_INFO_2W (Unicode) 和 _JOB_INFO_2A (ANSI)

另请参阅

打印

打印后台处理程序 API 结构

DEVMODE

EnumJobs

GetJob

SetJob