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

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: