SWbemObject.Subclasses_ メソッド
SWbemObject オブジェクトの Subclasses_ メソッドでは、SWbemObjectSet オブジェクトを返します。 このオブジェクトは、クラスである必要がある、現在のオブジェクトのサブクラスのコレクションです。 返されるコレクション内の項目は、標準のコレクション メソッドを使用して取得できます。 詳細については、コレクションへのアクセスに関する記事を参照してください。
この構文の説明については、スクリプト API のドキュメント規則に関する記事を参照してください。
構文
objWbemObjectSet = .Subclasses_( _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
パラメーター
-
iFlags [in、省略可能]
-
呼び出しの列挙の詳細度を決定する整数。 このパラメーターには次の値を指定することができます。
-
wbemQueryFlagDeep (0 (0x0))
-
指定した親クラスから派生したすべてのサブクラスに再帰的列挙を強制します。 親クラス自体は、列挙では返されません。
-
wbemQueryFlagShallow (1 (0x1))
-
このパラメーターの既定値。 指定した親クラスの直接サブクラスのみを列挙型に強制的に含めます。
-
WbemFlagReturnImmediately (16 (0x10))
-
呼び出しはすぐに返されます
-
wbemFlagReturnWhenComplete (0 (0x0))
-
呼び出しが完了するまで、この呼び出しをブロックします。
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
WMI で基底クラス定義と一緒にクラス変更データを返すようにします。
objwbemNamedValueSet [in、省略可能]
通常、これは未定義です。 そうでない場合、これは SWbemNamedValueSet オブジェクトであり、その要素は、要求を処理しているプロバイダーが使用できるコンテキスト情報を表します。 このような情報をサポートする、または必要とするプロバイダーは、認識された値名、値のデータ型、許可された値、セマンティクスを文書化する必要があります。
戻り値
呼び出しが成功した場合は、SWbemObjectSet オブジェクトが返されます。
エラー コード
Subclasses_ メソッドの完了後、Err オブジェクトに次の一覧のいずれかのエラー コードが含まれる場合があります。
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
現在のユーザーに、呼び出しから返される 1 つ以上のクラスを表示する権限がありません。
-
wbemErrFailed - 2147749889 (0x80041001)
-
未定義のエラーが発生しました。
-
wbemErrInvalidClass - 2147749904 (0x80041010)
-
指定されたクラスが存在しませんでした。
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
無効なパラメーターが指定されました。
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
操作を完了させるための十分なメモリがありません。
解説
現在のオブジェクトのサブクラスがない場合、返されるコレクションに要素が 0 個含まれるというのはエラーではありません。 Subclasses_ メソッドは、クラス オブジェクトに対してのみ機能します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows Vista |
サポートされている最小のサーバー |
Windows Server 2008 |
Header |
|
タイプ ライブラリ |
|
[DLL] |
|
CLSID |
CLSID_SWbemObject |
IID |
IID_ISWbemObject |