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