特定の 共通情報モデル (CIM) オブジェクトに関連付けられたクラスまたはインスタンスの列挙
Associators メソッドは、特定の 共通情報モデル (CIM) オブジェクトに関連付けられたクラスまたはインスタンスを列挙します。
パラメーター
表 1 は、Associators メソッドのパラメーターを説明しています。
| パラメーター | タイプ | 説明 |
|---|---|---|
| ObjectName | ストリング | 関連のソースであるクラス名またはインスタンス名を定義します。 |
| AssocClass | ストリング | NULL でない場合は、このクラスまたはそのサブクラスの 1 つのインスタンスによって、すべてのオブジェクトをソース・オブジェクトに関連付ける必要があることを示します。 |
| ResultClass | ストリング | NULL でない場合は、戻されるオブジェクトはすべて、このクラスまたはそのサブクラスのインスタンスであるか、このクラスでなければならないことを示します。 |
| Role | ストリング | NULL でない場合は、戻されるオブジェクトはいずれも、指定された役割を果たすソース・オブジェクトに関連付ける必要があることを示します。ソース・オブジェクトを参照する、関連クラス内のプロパティーの名前は、このパラメーター値と一致しなければなりません。 |
| ResultRole | ストリング | NULL でない場合は、戻されるオブジェクトはいずれも、指定された役割を果たすソース・オブジェクトに関連付ける必要があることを示します。つまり、戻されるオブジェクトを参照する関連クラスにおけるプロパティーの名前は、このパラメーターの値に一致していなければなりません。 |
| IncludeClassOrigin | ブール値 | TRUE は、クラスの CLASSORIGIN 属性を返します。 |
戻り値
成功した場合は、ゼロ個以上のクラス (CIMClass) またはインスタンス (Objects) が返されます。それ以外の場合、以下のいずれかのエラー・コードが返されます。
- CIM_ERR_ACCESS_DENIED
- CIM_ERR_INVALID_NAMESPACE
- CIM_ERR_INVALID_PARAMETER
- CIM_ERR_INVALID_CLASS
- CIM_ERR_FAILED