特定の 共通情報モデル (CIM) オブジェクトに関連付けられたクラスまたはインスタンスの列挙

Associators メソッドは、特定の 共通情報モデル (CIM) オブジェクトに関連付けられたクラスまたはインスタンスを列挙します。

パラメーター

表 1 は、Associators メソッドのパラメーターを説明しています。

表 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