MI_ProviderFT_ReferenceInstances function pointer

Enumerate association instances that refer to a particular CIM instance.

Syntax

typedef void ( MI_CALL *MI_ProviderFT_ReferenceInstances)(
  _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        *role,
  _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]
  Enumerate instances in this namespace.

• className [in]
  Enumerate instances of this class or subclasses of this class.

• instanceName [in]
  The name of the requested instance.

• role [in, optional]
  The association property name that refers to the specified instance.

• propertySet [in, optional]
  The list of required properties or NULL for all.

• keysOnly
  Set True to request only key properties.

• filter [in, optional]
  Filter the result instances.

Return value

This function pointer does not return a value.

Remarks

If successful, the implementation returns zero or more instances.

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

See also

MI_ProviderFT

MI_Context

MI_Filter

MI_Instance

MI_PropertySet