Win32_PrintJob クラス
Win32_PrintJobWMI クラスは、Windows アプリケーションによって生成された印刷ジョブを表します。 Windows オペレーティング システムで実行されているコンピューターで実行されているアプリケーションの print コマンドによって生成される作業単位は、このクラスの子孫またはメンバーです。
次の構文はマネージド オブジェクト フォーマット (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 クラスには、これらのメソッドがあります。
メソッド | 説明 |
---|---|
一時 停止 | 印刷ジョブを一時停止します。 |
再開 | 印刷ジョブを続行します。 |
プロパティ
Win32_PrintJob クラスには、これらのプロパティがあります。
-
Caption
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (64)、 DisplayName ("Caption")
オブジェクトの短いテキスト説明。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
-
-
Color
-
-
データ型: string
-
アクセスの種類: 読み取り専用
文書がカラーまたはモノクロで印刷されるかどうかを示す文字列。 一部のカラー プリンターでは、黄色、シアン、マゼンタの組み合わせではなく、真の黒を使用して印刷できます。 通常、True 黒の場合、文書のテキストが濃くシャープになります。 このオプションは、真の黒印刷をサポートするカラー プリンターでのみ役立ちます。
値は次のとおりです。
-
"Color"
-
"モノクロ"
-
-
DataType
-
-
データ型: string
-
アクセスの種類: 読み取り専用
この印刷ジョブのデータの形式。 これにより、プリンター ドライバーは、印刷前にデータ (汎用テキスト、PostScript、または PCL) を翻訳するか、未加工の形式 (グラフィックスと画像の場合) で印刷するように指示します。
例: "TEXT"
-
-
説明
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: DisplayName ("Description")
オブジェクトのテキスト説明。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
-
-
Document
-
-
データ型: string
-
アクセスの種類: 読み取り専用
印刷ジョブの名前。 印刷を待機しているドキュメントを表示すると、この名前がユーザーに表示されます。
例: "Microsoft Word - Review.doc"
-
-
DriverName
-
-
データ型: string
-
アクセスの種類: 読み取り専用
印刷ジョブに使用されるプリンター ドライバーの名前。
-
-
ElapsedTime
-
-
データ型: datetime
-
アクセスの種類: 読み取り専用
ジョブが実行されている時間の長さ。
このプロパティは、 CIM_Jobから継承されます。
-
-
HostPrintQueue
-
-
データ型: string
-
アクセスの種類: 読み取り専用
印刷ジョブが作成されるコンピューターの名前。
-
-
InstallDate
-
-
データ型: datetime
-
アクセスの種類: 読み取り専用
-
修飾子: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("インストール日")
オブジェクトがインストールされたタイミングを示します。 値がない場合、オブジェクトがインストールされていないことを示すわけではありません。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
-
-
JobId
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
ジョブの識別子番号。 これは、プリンターへのジョブ・スプーリングのハンドルとして、他の方法で使用されます。
-
-
JobStatus
-
-
データ型: string
-
アクセスの種類: 読み取り専用
ジョブの状態を表す自由形式の文字列。
このプロパティは、 CIM_Jobから継承されます。
-
-
名前
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: DisplayName ("Name")
オブジェクトが認識されるラベル。 サブクラス化すると、このプロパティをキー プロパティとしてオーバーライドできます。
このプロパティは 、CIM_ManagedSystemElementから継承されます。
-
-
通知
-
-
データ型: string
-
アクセスの種類: 読み取り専用
ジョブの完了または失敗時にユーザーに通知されます。
このプロパティは、 CIM_Jobから継承されます。
-
-
所有者
-
-
データ型: string
-
アクセスの種類: 読み取り専用
ジョブを送信したユーザー。
このプロパティは、 CIM_Jobから継承されます。
-
-
PagesPrinted
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
印刷されるページ数。 印刷ジョブにページ区切り情報が含まれていない場合、この値は 0 (ゼロ) になることがあります。
-
-
PaperLength
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: 単位 (ミリメートルの 10 分の 1)
用紙の長さ。
例: 2794
-
-
Papersize
-
-
データ型: string
-
アクセスの種類: 読み取り専用
ジョブの印刷に使用する用紙のサイズ。 値は、Win32_Printer クラスの PaperSizesSupported プロパティで指定されたプリンターに使用できる用紙サイズ の 1 つです。
-
-
PaperWidth
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: 単位 (ミリメートルの 10 分の 1)
用紙の幅。
例: 2159
-
-
パラメーター
-
-
データ型: string
-
アクセスの種類: 読み取り専用
印刷プロセッサに送信する省略可能なパラメーター。 詳細については、「 PrintProcessor プロパティ」を参照してください。
-
-
PrintProcessor
-
-
データ型: string
-
アクセスの種類: 読み取り専用
印刷ジョブの処理に使用される印刷プロセッサ サービス。 プリンター プロセッサは、プリンター ドライバーと連携して、プリンターのプリンター データの追加の翻訳を提供し、ジョブのタイトル ページなどの特別なオプションを提供するためにも使用できます。
-
-
優先順位
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
ジョブの実行の重要性。
このプロパティは、 CIM_Jobから継承されます。
-
-
[サイズ]
-
-
データ型: uint32
-
アクセスの種類: 読み取り専用
-
修飾子: 単位 (バイト)
印刷ジョブのサイズ。
-
-
StartTime
-
-
データ型: datetime
-
アクセスの種類: 読み取り専用
ジョブが開始された時刻。
このプロパティは、 CIM_Jobから継承されます。
-
-
状態
-
-
データ型: string
-
アクセスの種類: 読み取り専用
-
修飾子: MaxLen (10)、 DisplayName ("Status")
オブジェクトの現在の状態を示す文字列。 運用状態と非運用状態を定義できます。 操作状態には、"OK"、"低下"、"事前失敗" が含まれます。 "Pred Fail" は、要素が正しく機能しているが、エラー (SMART 対応ハード ディスク ドライブなど) を予測していることを示します。
非運用状態には、"エラー"、"開始中"、"停止中"、"サービス" が含まれる場合があります。 "サービス" は、ディスクのミラー、ユーザーのアクセス許可リストの再読み込み、またはその他の管理作業中に適用できます。 このような作業のすべてがオンラインであるわけではありませんが、マネージド要素は "OK" でも、他の状態の 1 つでもありません。
このプロパティは、 CIM_ManagedSystemElementから継承されます。
次の値があります。
-
-
OK ("OK")
-
エラー ("Error")
-
機能低下 ("Degraded")
-
不明 ("不明")
-
Pred Fail ("Pred Fail")
-
開始 ("開始")
-
停止中 ("停止中")
-
サービス ("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)
Deleted
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] |
|
こちらもご覧ください