Win32_PrintJob 類別

發行項
06/12/2023

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	Win32_Printer.mof
DLL	CIMWin32.dll

另請參閱

CIM_Job
電腦系統硬體類別

共用方式為

Win32_PrintJob 類別

語法

成員

方法

屬性

備註

範例

規格需求

另請參閱

意見反應

其他資源