AssociatorNames()
AssociatorNames() メソッドは、CIM オブジェクトに関連付けられたクラスまたはインスタンスの名前を列挙するのに使用できます。
パラメーター
表 212 は、AssociatorNames() メソッドに指定できるパラメーターを示します。
表 212. AssociatorNames() のパラメーター
|
パラメーター |
タイプ |
記述 |
| ObjectName |
COP |
関連のソースであるクラス名またはインスタンス名を定義します。 |
| AssocClass |
ストリング |
NULL でない場合は、戻されるオブジェクト・パスはすべて、このクラスまたは、
そのサブクラスのインスタンスによってソース・オブジェクトに関連付けられたオブジェクトを識別していることを示します。 |
| ResultClass |
ストリング |
NULL でない場合は、戻されるオブジェクト・パスはすべて、このクラスまたはそのサブクラスの 1 つのインスタンス、あるいはこのクラスを識別する必要があることを示します。 |
| 役割 |
ストリング |
NULL でない場合は、ソース・オブジェクトを参照する関連クラスにおけるプロパティーの名前は、このパラメーターの値に一致していなければなりません。 |
| ResultRole |
ストリング |
NULL でない場合は、戻されるオブジェクトを参照する、関連クラスにおけるプロパティーの名前は、このパラメーターの値に一致していなければなりません。 |
戻り値
AssociatorNames() メソッドは、クラスまたはインスタンスの名前を列挙するか、以下のエラー・コードのいずれかを戻します。
- CIM_ERR_ACCESS_DENIED
- CIM_ERR_INVALID_NAMESPACE
- CIM_ERR_INVALID_PARAMETER
- CIM_ERR_FAILED