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.
|
|
|
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