MI_Instance_GetElementAt function (mi.h)

Article
02/22/2024

Gets the value of the element (CIM property) at the specified index.

Syntax

MI_INLINE MI_Result MI_INLINE_CALL MI_Instance_GetElementAt(
  [in]            const MI_Instance *self,
                  MI_Uint32         index,
                  const MI_Char     **name,
  [out, optional] MI_Value          *value,
  [out, optional] MI_Type           *type,
  [out, optional] MI_Uint32         *flags
);

Parameters

[in] self

Instance whose element value will be returned.

index

Zero-based index of the element

name

A pointer to a null-terminated string containing the returned element name.

[out, optional] value

Returned element value.

[out, optional] type

Returned element type.

[out, optional] flags

Returned combination of the following values.

MI_FLAG_NULL (0x20000000)

Element value is Null.

MI_FLAG_KEY (0x0001000)

Element is a key.

MI_FLAG_IN (0x0002000)

The parameter is of type In and is passed into a method.

MI_FLAG_OUT (0x0004000)

The parameter is of type Out and is returned from a method.

Return value

A value of the MI_Result enumeration that specifies the function return code. This can be one of the following codes.

Requirements

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