MI_Instance_GetElement function (mi.h)

Gets the value of the named element (CIM property).

Syntax

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

Parameters

[in] self

Instance whose element value will be returned.

name

A null-terminated string that represents the name of the element.

[out, optional] value

Returned element value.

[out, optional] type

Returned element value 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.

[out, optional] index

Returned zero-based index of the element.

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

See also

MI_Instance_AddElement

MI_Instance_ClearElement

MI_Instance_SetElement