Windows Dev Center

Expand Minimize

MI_ProviderFT_AssociatorInstances function pointer

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

See also

MI_ProviderFT
MI_Context
MI_Filter
MI_Instance
MI_PropertySet

 

 

Show:
© 2015 Microsoft