Win32_PrintJob 類別
Win32_PrintJobWMI 類別代表 Windows 應用程式所產生的列印工作。 在 Windows 作業系統上執行之電腦上執行之應用程式的列印命令所產生的任何工作單位，都是這個類別的子系或成員。
下列語法已經過受管理物件格式 (MOF) 程式碼簡化，並包含所有已繼承的屬性。 屬性會依字母順序列出，而非 MOF 順序。
語法
class Win32_PrintJob : CIM_Job
{
string Caption;
string Description;
datetime InstallDate;
string Name;
string Status;
datetime ElapsedTime;
string JobStatus;
string Notify;
string Owner;
uint32 Priority;
datetime StartTime;
datetime TimeSubmitted;
datetime UntilTime;
string Color;
string DataType;
string Document;
string DriverName;
string HostPrintQueue;
uint32 JobId;
uint32 PagesPrinted;
uint32 PaperLength;
string PaperSize;
uint32 PaperWidth;
string Parameters;
string PrintProcessor;
uint32 Size;
uint32 StatusMask;
uint32 TotalPages;
};
成員
Win32_PrintJob類別具有下列類型的成員：
方法
Win32_PrintJob類別具有這些方法。
| 方法 | Description |
|---|---|
| 暫停 | 暫停列印工作。 |
| 繼續 | 繼續列印工作。 |
屬性
Win32_PrintJob類別具有這些屬性。
-
標題
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： MaxLen (64) 、 DisplayName (「Caption」)
物件的簡短文字描述。
此屬性繼承自 CIM_ManagedSystemElement。
-
-
Color
-
-
資料類型： 字串
-
存取類型：唯讀
指出檔是否以色彩或單色列印的字串。 某些色彩印表機能夠使用真正的黑色列印，而不是黃色、青色和 magenta 的組合。 True Black 通常會為檔建立較深且更清楚的文字。 此選項僅適用于支援真實黑色列印的色彩印表機。
值如下：
-
「Color」
-
「Monochrome」
-
-
DataType
-
-
資料類型： 字串
-
存取類型：唯讀
此列印工作的資料格式。 這會指示印表機驅動程式在列印之前，先轉譯一般文字、PostScript 或 PCL) (的資料，或列印圖形和圖片 (的原始格式) 。
範例：「TEXT」
-
-
說明
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： DisplayName (「Description」)
物件的文字描述。
此屬性繼承自 CIM_ManagedSystemElement。
-
-
文件
-
-
資料類型： 字串
-
存取類型：唯讀
列印工作的名稱。 當使用者檢視等候列印的檔時，會看到此名稱。
範例：「Microsoft Word - Review.doc」
-
-
DriverName
-
-
資料類型： 字串
-
存取類型：唯讀
用於列印工作的印表機驅動程式名稱。
-
-
ElapsedTime
-
-
資料類型： datetime
-
存取類型：唯讀
作業執行的時間長度。
此屬性繼承自 CIM_Job。
-
-
HostPrintQueue
-
-
資料類型： 字串
-
存取類型：唯讀
建立列印工作的電腦名稱稱。
-
-
InstallDate
-
-
資料類型： datetime
-
存取類型：唯讀
-
限定詞： MappingStrings (「MIF。DMTF|ComponentID|001.5「) ， DisplayName (」Install Date「)
指出何時安裝 物件。 缺少值並不表示未安裝物件。
此屬性繼承自 CIM_ManagedSystemElement。
-
-
JobId
-
-
資料類型： uint32
-
存取類型：唯讀
作業的識別碼。 其他方法會使用它做為工作多工緩衝處理至印表機的控制碼。
-
-
JobStatus
-
-
資料類型： 字串
-
存取類型：唯讀
表示作業狀態的免費格式字串。
此屬性繼承自 CIM_Job。
-
-
名稱
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： DisplayName (「Name」)
已知物件的標籤。 子類別化時，這個屬性可以覆寫為索引鍵屬性。
此屬性繼承自 CIM_ManagedSystemElement。
-
-
通知
-
-
資料類型： 字串
-
存取類型：唯讀
使用者會在作業完成或失敗時收到通知。
此屬性繼承自 CIM_Job。
-
-
擁有者
-
-
資料類型： 字串
-
存取類型：唯讀
提交作業的使用者。
此屬性繼承自 CIM_Job。
-
-
PagesPrinted
-
-
資料類型： uint32
-
存取類型：唯讀
列印的頁面數。 如果列印工作不包含分頁分隔資訊，此值可能是 0 (零) 。
-
-
PaperLength
-
-
資料類型： uint32
-
存取類型：唯讀
-
限定詞： 單位 (公釐的十分之一。)
紙張的長度。
範例：2794
-
-
PaperSize
-
-
資料類型： 字串
-
存取類型：唯讀
用來列印工作的紙張大小。 此值是Win32_Printer類別之PaperSizesSupported屬性中所指定印表機的其中一個可能紙張大小。
-
-
PaperWidth
-
-
資料類型： uint32
-
存取類型：唯讀
-
限定詞： 單位 (公釐的十分之一。)
紙張的寬度。
範例：2159
-
-
參數
-
-
資料類型： 字串
-
存取類型：唯讀
要傳送至列印處理器的選擇性參數。 如需詳細資訊，請參閱 PrintProcessor 屬性。
-
-
PrintProcessor
-
-
資料類型： 字串
-
存取類型：唯讀
用來處理列印工作的列印處理器服務。 印表機處理器可與印表機驅動程式搭配運作，以提供印表機資料的額外翻譯，也可以用來提供特殊選項，例如作業的封面頁面。
-
-
優先順序
-
-
資料類型： uint32
-
存取類型：唯讀
作業執行的重要性。
此屬性繼承自 CIM_Job。
-
-
大小
-
-
資料類型： uint32
-
存取類型：唯讀
-
限定詞： 單位 (位元組)
列印工作的大小。
-
-
StartTime
-
-
資料類型： datetime
-
存取類型：唯讀
作業開始的時間。
此屬性繼承自 CIM_Job。
-
-
狀態
-
-
資料類型： 字串
-
存取類型：唯讀
-
限定詞： MaxLen (10) 、 DisplayName (「Status」)
表示物件目前狀態的字串。 您可以定義作業和非操作狀態。 作業狀態可以包括 「OK」、「已降級」 和 「Pred Fail」。 「預先失敗」表示元素正常運作，但正在預測失敗 (例如，已啟用 SMART 的硬碟) 。
非操作狀態可以包含「錯誤」、「啟動」、「停止」和「服務」。 「服務」可以在磁片鏡像重新儲存期間套用、重載使用者許可權清單或其他系統管理工作。 並非所有這類工作都處於線上狀態，但 Managed 元素不是「確定」，也不是在其他其中一種狀態。
此屬性繼承自 CIM_ManagedSystemElement。
包括下列值：
-
-
確定 (「確定」)
-
錯誤 (「錯誤」)
-
降級 (「降級」)
-
未知 (「未知」)
-
Pred Fail (「預先失敗」)
-
starting (「Starting」)
-
停止 (「停止」)
-
服務 (「Service」)
-
壓力 (「壓力」)
-
NonRecover (「NonRecover」)
-
無連絡人 (「無連絡人」)
-
Lost Comm (「Lost Comm」)
StatusMask
-
資料類型： uint32
-
存取類型：唯讀
與這個列印工作相關的可能狀態點陣圖。
1 (0x1)
已暫停
2 (0x2)
錯誤
4 (0x4)
刪除中
8 (0x8)
假 離線
16 (0x10)
列印
32 (0x20)
離線
64 (0x40)
紙張
128 (0x80)
列印
256 (0x100)
已刪除
512 (0x200)
Blocked_DevQ
1024 (0x400)
User_Intervention_Req
2048 (0x800)
重新啟動
TimeSubmitted
-
資料類型： datetime
-
存取類型：唯讀
提交作業的時間。
此屬性繼承自 CIM_Job。
TotalPages
-
資料類型： uint32
-
存取類型：唯讀
完成作業所需的頁數。 如果列印工作不包含頁面分隔資訊，此值可能是 0 (零) 。
UntilTime
-
資料類型： datetime
-
存取類型：唯讀
作業無效或應該停止的時間。
此屬性繼承自 CIM_Job。
備註
Win32_PrintJob類別衍生自CIM_Job。
範例
下列 VBScript 程式碼範例說明如何從 Win32_PrintJob實例擷取印表機作業統計資料。
Set PrintJobSet = GetObject("winmgmts:").InstancesOf ("Win32_PrintJob")
If (PrintJobSet.Count = 0) Then WScript.Echo "No print jobs!"
for each PrintJob in PrintJobSet
WScript.Echo PrintJob.Name
WScript.Echo PrintJob.JobId
WScript.Echo PrintJob.Status
WScript.Echo PrintJob.TotalPages
Wscript.Echo ""
next
下列 Perl 程式碼範例說明如何從 Win32_PrintJob實例擷取印表機作業統計資料。
use strict;
use Win32::OLE;
close (STDERR);
my ($PrintJobset, $PrintJob);
eval {$PrintJobset = Win32::OLE->GetObject("winmgmts:{impersonationLevel=impersonate}")->
InstancesOf ("Win32_PrintJob") };
if (!$@ && defined $PrintJobset)
{
if ($PrintJobset->{Count} == 0 )
{
print "\nNo print jobs!\n";
}
foreach $PrintJob (in $PrintJobset)
{
print $PrintJob->{Name} , "\n";
print $PrintJob->{JobId} , "\n";
print $PrintJob->{Status} , "\n";
print $PrintJob->{TotalPages} , "\n";
}
}
else
{
print Win32::OLE->LastError, "\n";
}
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows Vista |
| 最低支援的伺服器 |
Windows Server 2008 |
| 命名空間 |
Root\CIMV2 |
| MOF |
|
| DLL |
|
另請參閱
意見反應
即將登場：在 2024 年，我們將逐步淘汰 GitHub 問題作為內容的意見反應機制，並將它取代為新的意見反應系統。 如需詳細資訊，請參閱：https://aka.ms/ContentUserFeedback。
提交並檢視相關的意見反應