標準 WMI 修飾子

次に、WMI に固有の標準修飾子を示します。

契約

データ型: ブール値

適用対象: クラス

クラスに、ローカライズされた修正済みの修飾子が含まれていることを示します。 既定値は TRUE です。

関連付けられたクラスは変換できます。 翻訳されたバージョンにアクセスするには、ロケール識別子を使用して名前空間の名前を作成します。

GetObject をバイパスする _

データ型: ブール値

適用対象: メソッド

メソッド呼び出しが、最初に GetObject を呼び出してオブジェクトパスを検証するのではなく、プロバイダーの execmethodasync 呼び出しに直接渡す必要があることを示します。 既定値は FALSE です。 _ GetObject を使用すると、パフォーマンスを大幅に向上させることができます。

GetObject の バイパス _ を使用する前に、次のいずれの操作も行わないようにしてください。

  • クラスからクラスを派生させます。
  • _ GetObject のバイパス 修飾子を持つメソッドをオーバーライドします。

これらの予防措置に従わないと、子クラスではなく親クラスのメソッド実装が呼び出される可能性があります。 詳細については、「バイパスの GetObject 修飾子の使用」を参照してください _ 。

CIM _ キー

データ型: CIM _ ブール値

適用対象: プロパティ

関連付けられているプロパティが、WMI ではなく CIM のキープロパティであることを示します。

CIMType

データ型: VT _ BSTR

適用対象: プロパティ、メソッド、パラメーター

プロパティの型を説明するテキストを格納します。

ClassContext

データ型: VT _ BSTR

適用対象: クラス

プロバイダーによって動的に提供される詳細情報に関連付けられたインスタンスがクラスにあることを示します。

データ型: CIM _ ブール値

適用対象: プロパティ、クラス

プロパティが別のプロパティによって置き換えられていることを示します。

'95'5c

適用対象: クラス、プロパティ

関連付けられているクラスの UUID

動的

データ型: ブール値

適用対象: クラス、プロパティ

インスタンスが動的に作成されるクラスを示します。 この修飾子の値は TRUE に設定する必要があります。

DynProps

データ型: ブール値

適用対象: クラス、インスタンス

動的プロパティプロバイダーによって提供される値がインスタンスに格納されていることを示します。 既定値は TRUE です。

このようなインスタンスでは、この修飾子を指定する必要があります。 値 TRUE のみが許可されます。

固定

データ型: CIM _ ブール値

適用対象: インスタンス

インスタンスの有効期間中は、このプロパティの値を変更できないことを示します。

番号

データ型: VT _ I4

適用対象: プロパティ、パラメーター

MOF ステートメントが自動的に生成されるときに、プロパティまたはメソッドパラメーターを一意に識別し、シーケンスします。

この修飾子は、メソッドのパラメーターにのみ必要です。 メソッドのパラメーターを作成する場合、クラスデザイナーは最初のパラメーターとして Id (0) で始まり、連続する各パラメーターに連続する各整数を使用する必要があります。 Id 修飾子が誤って省略された場合、MOF コンパイラは自動的に id 修飾子を生成します。

データ型: ブール値

適用対象: メソッド

メソッドにプロバイダーによって提供される実装があることを示します。

InstanceContext

データ型: VT _ BSTR

適用対象: インスタンス

動的プロパティプロバイダーによって提供される値がインスタンスに格納されていることを示します。

値は、 IWbemPropertyProvider:: GetProperty メソッドの引数としてプロパティプロバイダーに渡されます。

データ型: VT _ BSTR

適用対象: クラスまたはインスタンス

クラスまたはインスタンスの元の言語を指定します。 ロケール値の詳細については、「 ロケールコード」を参照してください。

NamespaceSecuritySDDL

データ型: 文字列配列

適用対象: 名前空間のインスタンス

SDDL形式で名前空間のセキュリティ記述子を指定します。 詳細については、「名前空間 の作成時に名前空間のセキュリティを設定する」を参照してください。 SDDL 文字列は、名前空間のセキュリティを確立するために WMI によって処理されますが、文字列として格納されることはありません。 セキュリティ記述子が指定されていない場合は、既定のセキュリティが使用されます。 詳細については、「 Namepace セキュリティ記述子の設定」を参照してください。

Optional

データ型: ブール値

適用対象: パラメーター

パラメーターが必須ではなく、適切に動作する既定値があることを示します。

権限

データ型: 文字列配列

適用対象: プロパティ、メソッド

インスタンスを作成したり、プロパティを設定したり、メソッドを実行したりするために必要な特権をクライアントに通知するために使用される値のセット。 既定値は FALSE です。

PropertyContext

データ型: VT _ BSTR

適用対象: プロパティ

インスタンスプロパティに動的プロパティプロバイダーによって提供される値が含まれていることを示します。

このようなプロパティには、この修飾子を指定する必要があります。 値は、 IWbemPropertyProvider:: GetPropertyへの引数としてプロパティプロバイダーに渡されます。

Provider

データ型: VT _ BSTR

適用対象: クラス

この修飾子の値は、クラスインスタンスを提供し、インスタンスデータを更新する動的プロバイダーの名前です。 この名前は、この名前を含む name プロパティを使用して _ _ Win32Providerクラスのインスタンスを作成することによって、WMI に登録する必要があります。 この修飾子が、インスタンスが動的に提供されるクラスに指定されている場合は、 動的 修飾子も指定する必要があります。

RequiresEncryption

データ型: ブール値

適用対象: 名前空間のインスタンス

TRUE に設定すると、 RequiresEncryption は、クライアントアプリケーションとスクリプトが暗号化された認証で接続する必要があるように名前空間をマークします。 C++ では、認証レベルを RPC _ C _ AUTHN _ level _ PKT _ privacy に設定する必要があります。 スクリプトまたは Visual Basic では、認証レベルを WbemAuthenticationLevelPktPrivacy に設定する必要があります。 詳細については、「 Namepace セキュリティ記述子の設定」を参照してください。 この修飾子は、 MOF でプラグマ名前空間プリプロセッサコマンドと共に使用されます。

詳細については、「 C++ を使用して既定のプロセスセキュリティレベルを設定 する」または「 VBScript を使用して既定のプロセスセキュリティレベルを設定する」を参照してください。 スクリプト認証レベルは、 WbemAuthenticationLevelEnumで定義されています。

単独

データ型: ブール値

適用対象: クラス

インスタンスを1つだけ持つことができ、キープロパティを含まないクラスを指定します。

TRUE (既定値) のみが許可されます。

雑音

データ型: ブール値

適用対象: メソッド

クラス定義またはそのインスタンスを使用して、メソッドを呼び出すことができるかどうかを示します。

インスタンスからメソッドを呼び出すことはできません。

内部

データ型: VT _ BSTR

適用対象: プロパティ

CIM _ DATETIME 型のプロパティが、特定の時刻ではなく時間間隔を表すことを示します。

プロパティを間隔として識別するには、この修飾子の値が "interval" である必要があります。 この修飾子の他のすべての値は、将来使用するために予約されています。

UUID

データ型: 文字列

適用対象: クラス

クラスに適用される汎用一意識別子。

ClassVersion

データ型: 文字列

適用対象: クラス

クラスオブジェクトのバージョン番号。 既定値は NULL です。 クラスに変更が加えられると、バージョン番号がインクリメントされます。

WritePrivileges

データ型: 文字列配列

適用対象: プロパティ

書き込み操作を正常に実行できるようにする必要があるシステム特権を示す値のセット。

解説

ロケールコード

ロケールコードの形式は、"MS _ " です。 たとえば、英語のロケールは MS _ 409 です。 次の表に、言語 Id の一覧を示します。

Language 言語 ID (16 進数)
アラビア語 401
ポルトガル語 (ブラジル) 416
簡体中国語 804
繁体中国語 404
チェコ語 405
デンマーク語 406
オランダ語 413
英語 (既定) 409
フィンランド語 40b
フランス語 40c
ドイツ語 407
ギリシャ語 408
ヘブライ語 40d
ハンガリー語 40e
イタリア語 410
日本語 411
韓国語 412
ノルウェー語 414
ポーランド語 415
ポルトガル語 (ポルトガル) 816
ロシア語 419
スペイン語 c0a
スウェーデン語 41D
トルコ語 41f

バイパスの _ GetObject 修飾子の使用

メソッドに対して バイパスの _ GetObject 修飾子を使用すると、混乱を招く結果が生じる可能性があります。

次の例では、 図形 クラスを定義します。 Circle クラスは Shape クラスから派生することに注意してください。

class Shape
{
   string Name;
   uint32 DrawIt();  // - draws an irregular geometric shape
};

class Circle : Shape
{
   uint32 DrawIt();  // - draws a circle
};

次の ExecMethod の呼び出しでは、"mycircle" という名前の オブジェクトを使用して円を描画します。

ExecMethod("Shape.Name='MyCircle'","DrawIt");

前のシナリオでは、WMI は GetObject を呼び出します。"Shape. Name = ' MyCircle '" が であることを検出します。DrawIt 実装を実行します。 ただし、 DrawIt でバイパスの _ getobject 修飾子を使用すると、WMI は getobject を呼び出しません。 "shape. Name = ' mycircle '" は であり、 DrawIt 実装ではなく、 DrawIt形状 実装を実行します。

次の ExecMethod の呼び出しでは、常に DrawIt の正しい実装が呼び出されます。

ExecMethod("Circle.Name='MyCircle'","DrawIt");

必要条件

要件
サポートされている最小のクライアント
Windows Vista
サポートされている最小のサーバー
Windows Server 2008

関連項目

Namepace セキュリティ記述子の設定

WMI 修飾子

修飾子の追加