MI_ProviderFT_AssociatorInstances function pointer

Article
10/08/2016

Finds all CIM instances associated with a specified CIM instance.

Syntax

typedef void ( MI_CALL *MI_ProviderFT_AssociatorInstances)(
  _In_opt_       void           *self,
  _In_           MI_Context     *context,
  _In_     const MI_Char        *nameSpace,
  _In_     const MI_Char        *className,
  _In_     const MI_Instance    *instanceName,
  _In_opt_ const MI_Char        *resultClass,
  _In_opt_ const MI_Char        *role,
  _In_opt_ const MI_Char        *resultRole,
  _In_opt_ const MI_PropertySet *propertySet,
                 MI_Boolean     keysOnly,
  _In_opt_ const MI_Filter      *filter
);

Parameters

self [in, optional]
The provider state data.
context [in]
The request context.
nameSpace [in]
The target namespace.
className [in]
The name of the association class, or NULL. If not NULL, only instances associated to the source instance through an instance of this class or one of its subclasses are returned.
instanceName [in]
The source CIM instance, whose associated instances are returned.
resultClass [in, optional]
The name of the result class, or NULL. Only instances of this class or one of its subclasses are returned. This cannot be an association class.
role [in, optional]
The property name referring to the source instance. If not NULL, only instances that are associated with the source instance through an association that contains a reference property with this name that refers to the source instance.
resultRole [in, optional]
The property name referring to the result instances. If not NULL, only instances that are associated with the source instance through an association that contains a reference property with this name that refers to the returned instances.
propertySet [in, optional]
The names of properties to include or NULL for all. If the propertySet parameter contains invalid properties, the request will be rejected.
keysOnly
Set True to request only key properties.
filter [in, optional]
Filter the result instances, which could be of different types.

Return value

This function pointer does not return a value.

Remarks

On completion the implementation must post the result by using the MI_Context_PostResult method. The expected result is one of the following values.

MI_RESULT_OK

MI_RESULT_ACCESS_DENIED

MI_RESULT_INVALID_NAMESPACE

MI_RESULT_INVALID_PARAMETER

MI_RESULT_NOT_SUPPORTED

MI_RESULT_FAILED

Requirements

Minimum supported client	Windows 8
Minimum supported server	Windows Server 2012
Redistributable	Windows Management Framework 3.0 on Windows Server 2008 R2 with SP1, Windows 7 with SP1, and Windows Server 2008 with SP2
Header	Mi.h

Share via