勇芳软件工作室.汉化:  Printing > Print Spooler API > Print Spooler API Reference > Print Spooler API Structures >

JOB_INFO_1

Previous pageReturn to chapter overviewNext page

描述

 

JOB_INFO_1结构指定打印作业信息,例如作业标识符值,作业被假脱机的打印机的名称,创建打印作业的机器的名称,拥有打印的用户的名称工作等等。

 

C++ 语法

 

typedef struct _JOB_INFO_1 {

DWORD      JobId;

LPTSTR     pPrinterName;

LPTSTR     pMachineName;

LPTSTR     pUserName;

LPTSTR     pDocument;

LPTSTR     pDatatype;

LPTSTR     pStatus;

DWORD      Status;

DWORD      Priority;

DWORD      Position;

DWORD      TotalPages;

DWORD      PagesPrinted;

SYSTEMTIME Submitted;

} JOB_INFO_1,

*PJOB_INFO_1;

 

PowerBASIC 语法

 

TYPE JOB_INFO_1A

JobId        AS DWORD

pPrinterName AS ASCIIZ PTR

pMachineName AS ASCIIZ PTR

pUserName    AS ASCIIZ PTR

pDocument    AS ASCIIZ PTR

pDatatype    AS ASCIIZ PTR

pStatus      AS ASCIIZ PTR

Status       AS DWORD

Priority     AS DWORD

Position     AS DWORD

TotalPages   AS DWORD

PagesPrinted AS DWORD

Submitted    AS SYSTEMTIME

END TYPE

 

Unicode版本:

 

TYPE JOB_INFO_1W

JobId        AS DWORD

pPrinterName AS WSTRINGZ PTR

pMachineName AS WSTRINGZ PTR

pUserName    AS WSTRINGZ PTR

pDocument    AS WSTRINGZ PTR

pDatatype    AS WSTRINGZ PTR

pStatus      AS WSTRINGZ PTR

Status       AS DWORD

Priority     AS DWORD

Position     AS DWORD

TotalPages   AS DWORD

PagesPrinted AS DWORD

Submitted    AS SYSTEMTIME

END TYPE

 

成员

 

JobId

 

指定作业标识符。

 

pPrinterName

 

指向以空值终止的字符串的指针,该字符串指定作业假脱机的打印机的名称。

 

pMachineName

 

指向指定创建打印作业的计算机的名称的以空值终止的字符串的指针。

 

pUserName

 

指向以空值终止的字符串,指定拥有打印作业的用户的名称。

 

pDocument

 

指向指定打印作业名称(例如“MS-WORD:Review.doc”)的以空值终止的字符串的指针。

 

pDatatype

 

指向以空值终止的字符串,指定用于记录打印作业的数据类型。

 

pStatus

 

指向指定打印作业状态的以空值终止的字符串的指针。在状态之前应该检查此成员,如果pStatus为NULL,则该状态由状态成员的内容定义。

 

Status

 

指定作业状态。该成员的值可以为零或以下值中的一个或多个的组合。值为零表示在文件完成假脱机后打印队列已暂停。

 

含义

JOB_STATUS_BLOCKED_DEVQ

司机无法打印作业。

JOB_STATUS_COMPLETE

Windows XP及更高版本:作业已发送到打印机,但作业可能尚未打印。

 

有关详细信息,请参阅备注。

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_RETAINED

Windows Vista及更高版本:作业已保留在打印队列中,无法删除。这可能是由以下原因引起的:

 

1)通过调用SetJob手动保留作业,并且假脱机程序正在等待作业被释放。

 

2)作业没有完成打印,必须完成打印才能自动删除。

 

有关打印作业命令的更多信息,请参阅SetJob.

JOB_STATUS_SPOOLING

作业是假脱机。

JOB_STATUS_USER_INTERVENTION

打印机有一个错误,需要用户做某事。

 

Priority

 

指定作业优先级。该成员可以是以下值之一,也可以是1到99之间的范围(MIN_PRIORITY到MAX_PRIORITY)。

 

含义

MIN_PRIORITY

最低优先级

MAX_PRIORITY

最大优先级。

DEF_PRIORITY

默认优先级。

 

Position

 

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

 

TotalPages

 

指定文档包含多少页。如果打印作业不包含分页信息,则此值可能为零。

 

PagesPrinted

 

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

 

Submitted

 

指定此文档假脱机的时间的SYSTEMTIME结构。

 

此时间值为世界时协调(UTC)格式。在显示之前,您应将其转换为本地时间值。您可以使用FileTimeToLocalFileTime函数来执行转换。

 

备注

 

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

 

引用文件 #INCLUDE Once

 

WinSpool.inc(包括Windows.inc)