Returns the instances related to the source object through an association. Results are filtered based on the argument you pass in.

Arguments

Accepts the following arguments.

Argument Description
class_name Name of the class for which you want to get the associated instances.
selectors Set keys as a reference to a hash. Used to identify the instance of the class mentioned in the class_name argument.
associationclassname (optional) Name of the association class for the instance.
role (optional) Role that the object plays in the association class. The method filters the results according to the role.
resultclassname (optional) Result class name, which must be present in the association. The method returns only those instances.
resultrole (optional) Role that the result class plays in this instance. The method returns the results based on resultrole.
includeresult (optional) Further filters query results based on properties of the instances. You can pass in properties as a name-value hash, then pass in a reference to this hash in the includeresult named argument.
namespace Default CIM namespace. Default is root/cimv2.

If the namespace is not root/cimv2, you must pass in the namespace of the class in this argument.

Example

$client->EnumerateAssociatedInstances(
                                      class_name => 'CIM_Foo',
                                      selectors => \%hash;
                                      associationclassname => 'CIM_Bar',        #optional
                                      role => 'CIM_Baz',                        #optional
                                      resultclassname => 'CIM_Bat',             #optional
                                      resultrole => 'CIM_Quux',                 #optional
                                      includeresult => \%hash,                  #optional
                                      namespace => 'root/cimv2'                 #optional