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 之前檢查,如果 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
-
作業所需的頁數。 如果列印工作不包含頁面分隔資訊,這個值可能會是零。
-
大小
-
作業的大小,以位元組為單位。
-
已提交
-
SYSTEMTIME結構,指定提交作業的時間。
這個時間值是通用時間座標 (UTC) 格式。 您應該先將它轉換成當地時間值,再顯示它。 您可以使用 FileTimeToLocalFileTime 函式來執行轉換。
-
Time
-
自作業開始列印以來經過的總時間,以毫秒為單位。
-
PagesPrinted
-
已列印的頁數。 如果列印工作不包含分頁分隔資訊,這個值可能會是零。
備註
不支援 TrueEndOfJob 的埠監視器會在作業提交至印表機之後,將作業設定為JOB_STATUS_PRINTED。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows 2000 Server [僅限傳統型應用程式] |
標頭 |
|
Unicode 與 ANSI 名稱 |
_JOB_INFO_2W (Unicode ) 和 _JOB_INFO_2A (ANSI) |