JOB_INFO_4結構

  • 發行項

描述與作業相關聯的一組完整值，並支援大小為 64 位的大型多工緩衝處理檔案。

語法

typedef struct _JOB_INFO_4 {
  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;
  LONG                 SizeHigh;
} JOB_INFO_4, *PJOB_INFO_4;

成員

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 之前檢查，如果 pStatus 為 Null，狀態是由 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

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

大小

作業大小較低的四個位元組，以位元組為單位。 另請參閱下方 的 SizeHigh 成員。

已提交

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

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

Time

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

PagesPrinted

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

SizeHigh

作業大小較高的四個位元組，以位元組為單位。 另請參閱上述 的 Size 成員。

備註

不支援 TrueEndOfJob 的埠監視器會在作業提交至印表機之後立即將作業設定為JOB_STATUS_PRINTED。

規格需求

需求 值
最低支援的用戶端
 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器
 Windows 2000 Server [僅限傳統型應用程式]
標頭
Winspool.h
Unicode 與 ANSI 名稱
 _JOB_INFO_4W (Unicode ) 和 _JOB_INFO_4A (ANSI)

另請參閱

列印

列印多工緩衝處理器 API 結構

DEVMODE

EnumJobs

GetJob

SetJob