SWbemServices.SubclassesOf メソッド

SWbemServices オブジェクトの SubclassesOf メソッドは、SWbemObjectSet オブジェクトを返します。 このオブジェクトは、指定したクラスのサブクラスのコレクションです。 返されるコレクション内の項目は、標準のコレクション メソッドを使用して取得できます。 詳細については、コレクションへのアクセスに関する記事を参照してください。

このメソッドは、クラス オブジェクトに対してのみ機能します。

メソッドは、半同期モードで呼び出されます。 詳細については、「メソッドの呼び出し」を参照してください。

この構文の説明については、「スクリプト API のドキュメント規則」を参照してください。

構文

objWbemObjectSet = .SubclassesOf( _
  [ ByVal strSuperclass ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

パラメーター

strSuperclass [オプション]

親クラス名を指定します。 このクラスのサブクラスのみが列挙子で返されます。 このパラメータを空白のままにし、iFlags が wbemQueryFlagShallow の場合は、最上位クラス (つまり、親クラスを持たないクラス) のみが返されます。 このパラメータが空白で、iFlags が wbemQueryFlagDeep の場合、名前空間内のすべてのクラスが返されます。

iFlags [オプション]

呼び出しの列挙の詳細度を決定します。 このパラメータの既定値は wbemFlagReturnImmediately と wbemQueryFlagDeep です。 このパラメータには次の値を指定できます。

wbemQueryFlagShallow (1 (0x1))

指定した親クラスの直接サブクラスのみが強制的に列挙に含まれます。

wbemQueryFlagDeep (0 (0x0))

このパラメータの既定値。 この値は、指定した親クラスから派生したすべてのサブクラスに対して再帰的列挙を強制します。 親クラスは、列挙では返されません。

wbemFlagReturnImmediately (16 (0x10))

呼び出しはすぐに戻ります。

wbemFlagReturnWhenComplete (0 (0x0))

呼び出しが完了するまで、この呼び出しをブロックします。 このフラグは、メソッドを同期モードで呼び出します。

wbemFlagUseAmendedQualifiers (131072 (0x20000))

WMI で基底クラス定義と共にクラス変更データを返すようにします。 詳細については、「WMI クラス情報のローカライズ」を参照してください。

戻り値

メソッドが成功すると、SWbemObjectSet オブジェクトが返されます。

エラー コード

SubclassesOf メソッドの完了後に、Err オブジェクトに次のリストのいずれかのエラー コードが含まれる場合があります。

wbemErrAccessDenied - 2147749891 (0x80041003)

現在のユーザーには、呼び出しによって返された 1 つ以上のクラスを表示する権限がありません。

wbemErrFailed - 2147749889 (0x80041001)

未定義のエラーが発生しました。

wbemErrInvalidClass - 2147749904 (0x80041010)

指定されたクラスが存在しません。

wbemErrInvalidParameter - 2147749896 (0x80041008)

無効なパラメーターが指定されました。

wbemErrOutOfMemory - 2147749894 (0x80041006)

操作を完了させるための十分なメモリがありません。

例

次の PowerShell サンプルは、リモート システム上のクラスのサブクラスを取得する方法を示しています。

$NameSpace = 'root\ccm'
$ComputerName = 'sccm.company.com'
$WbemLocator = New-Object -ComObject "WbemScripting.SWbemLocator"
$WbemServices = $WbemLocator.ConnectServer($ComputerName, $Namespace)
$WbemClasses = $WbemServices.SubclassesOf()
$WbemClasses

要件

関連項目

SWbemServices

SWbemObjectSet