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。 此版本不支援擷取和設定檔安全性描述元。

狀態

作業狀態。 這個成員可以是下列一或多個值。

意義
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 作業已在列印後保留在列印佇列中。

優先順序

作業優先順序。 這個成員可以是下列其中一個值,或介於 1 到 99 之間 (MIN_PRIORITY到MAX_PRIORITY) 的範圍。

意義
MIN_PRIORITY 最低優先順序。
MAX_PRIORITY 優先順序上限。
DEF_PRIORITY 預設優先順序。

位置

作業在列印佇列中的位置。

StartTime

最早可以列印工作的時間。

UntilTime

可以列印工作的最新時間。

TotalPages

作業所需的頁數。 如果列印工作不包含分頁分隔資訊,這個值可能會是零。

大小

作業的大小,以位元組為單位。

已提交

SYSTEMTIME結構,指定提交作業的時間。

這個時間值是通用時間座標 (UTC) 格式。 您應該先將它轉換成當地時間值,再加以顯示。 您可以使用 FileTimeToLocalFileTime 函式來執行轉換。

Time

作業開始列印之後經過的總時間,以毫秒為單位。

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