SWbemObject.Instances_ メソッド
SWbemObject オブジェクトの Instances_ メソッドは、現在のクラス オブジェクトのインスタンスを返す列挙子を作成します。 このメソッドは、単純なクエリを実装します。 より複雑なクエリでは、SWbemServices.ExecQuery の使用が必要になる場合があります。
この構文の説明については、「スクリプト API のドキュメント規則」を参照してください。
構文
objWbemObjectSet = .Instances_( _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
パラメーター
-
iFlags [in, optional]
-
呼び出しの動作を決定する整数。 このパラメーターには次の値を指定することができます。
-
wbemFlagForwardOnly (32 (0x20))
-
順方向専用の列挙子を返します。 一般的に、順方向専用の列挙子は、従来の列挙子よりもずっと高速で、使用されるメモリが少なくなりますが、SWbemObject.Clone_ の呼び出しは許可されません。
-
wbemFlagBidirectional (0 (0x0))
-
クライアントが列挙子を解放するまで、WMI で列挙のオブジェクトへのポインターが保持されます。
-
wbemFlagReturnImmediately (16 (0x10))
-
このパラメーターの既定値。 このフラグを指定すると、呼び出しはすぐに返されます。
-
wbemFlagReturnWhenComplete ( 0 (0x0))
-
クエリが完了するまで、この呼び出しをブロックします。
-
wbemQueryFlagShallow (1 (0x1))
-
指定した親クラスの直接サブクラスのみが強制的に列挙に含まれます。
-
wbemQueryFlagDeep (0 (0x0))
-
このパラメーターの既定値。 この値により、階層内のすべてのクラスが列挙型に強制的に含まれます。
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
WMI で基底クラス定義と共にクラス変更データを返すようにします。
objwbemNamedValueSet [in、省略可能]
通常、これは未定義です。 そうでない場合、これは SWbemNamedValueSet オブジェクトであり、その要素は、要求を処理しているプロバイダーが使用できるコンテキスト情報を表します。 このような情報をサポートする、または必要とするプロバイダーは、認識された値名、値のデータ型、許可された値、セマンティクスを文書化する必要があります。
戻り値
メソッドが成功すると、SWbemObjectSet オブジェクトが返ります。
エラー コード
Instances_ メソッドの完了後に、Err オブジェクトに次のリストのいずれかのエラー コードが含まれる場合があります。
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
指定されたクラスのインスタンスを表示するためのアクセス許可が現在のユーザーにありません。
-
wbemErrFailed - 2147749889 (0x80041001)
-
未指定のエラーが発生しました。
-
wbemErrInvalidClass - 2147749904 (0x80041010)
-
指定されたクラスが無効です。
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
指定されたパラメータが無効です。
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
操作を完了させるための十分なメモリがありません。
解説
Instances_ メソッドは、クラス オブジェクトに対してのみ機能します。 返されるコレクションに要素が含まれていなくてもエラーではありません。 IFlags の既定値 wbemFlagReturnImmediately のため、このメソッドの既定の動作は半同期です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista |
| サポートされている最小のサーバー |
Windows Server 2008 |
| Header |
|
| タイプ ライブラリ |
|
| [DLL] |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |