Export (0) Print
Expand All
Expand Minimize

MI_Instance_GetElementAt function

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

Syntax


 MI_INLINE MI_Result MI_Instance_GetElementAt(
  _In_      const MI_Instance                               *self,
                  MI_Uint32                                 index,
            const _Outptr_result_maybenull_z_ const MI_Char **name,
  _Out_opt_       MI_Value                                  *value,
  _Out_opt_       MI_Type                                   *type,
  _Out_opt_       MI_Uint32                                 *flags
);

Parameters

self [in]

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.

value [out, optional]

Returned element value.

type [out, optional]

Returned element type.

flags [out, optional]

Returned combination of the following values.

flagsMeaning
MI_FLAG_NULL
0x2000000

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.

Return codeDescription
MI_RESULT_OK

The operation succeeded.

MI_RESULT_SERVER_LIMITS_EXCEEDED

There is not enough memory to complete the request.

MI_RESULT_INVALID_PARAMETER

One or more parameters passed to the function were not valid.

MI_RESULT_NOT_FOUND

Specified element does not exist.

MI_RESULT_FAILED

A failure not covered by other MI_Result error codes.

 

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_Instance
MI_Instance_ClearElementAt
MI_Instance_GetElementCount
MI_Instance_SetElementAt

 

 

Show:
© 2015 Microsoft