共用方式為


JOB_INFO_1 結構

JOB_INFO_1結構會指定列印工作資訊,例如作業識別碼值、工作緩衝處理的印表機名稱、建立列印工作的電腦名稱稱、擁有列印工作的使用者名稱等等。

語法

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;

成員

JobId

作業識別碼。

pPrinterName

Null 終止字串的指標,指定工作緩衝處理之印表機的名稱。

pMachineName

Null 終止字串的指標,指定建立列印工作的電腦名稱稱。

pUserName

Null 終止字串的指標,指定擁有列印工作的使用者名稱。

pDocument

指定列印 (作業名稱的 null 終止字串指標,例如 「MS-WORD: Review.doc」) 。

pDatatype

Null 終止字串的指標,指定用來記錄列印工作的資料類型。

pStatus

指定列印工作狀態之 Null 終止字串的指標。 此成員應在 Status 之前檢查,如果 pStatusNull,狀態是由 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 印表機發生錯誤,需要使用者執行某些動作。

優先順序

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

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

位置

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

TotalPages

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

PagesPrinted

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

已提交

SYSTEMTIME結構,指定此檔多工緩衝處理的時間。

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

備註

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

規格需求

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

另請參閱

列印

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

EnumJobs

GetJob

SetJob