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 之前檢查，如果 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	印表機發生錯誤，需要使用者執行某些動作。

優先順序

作業優先順序。 這個成員可以是下列其中一個值，或介於 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