MI_Instance_AddElement 函数 (mi.h)

向动态实例添加新属性, (仅受动态实例支持,其架构可能在运行时) 扩展。

语法

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

parameters

[in, out] self

元素将添加到的实例。

name

一个以 null 结尾的字符串,表示新元素的名称。

[in, optional] value

元素值。

type

元素类型。

flags

新元素的标志,可以是以下标志值的组合。

MI_FLAG_KEY (0x00001000)

元素是一个键。

MI_FLAG_IN (0x00002000)

参数的类型为 In,并传递到 方法中。

MI_FLAG_OUT (0x00004000)

参数的类型为 Out,是从 方法返回的。

MI_FLAG_REQUIRED (0x00008000)

参数是必需的。

MI_FLAG_STREAM (0x00100000)

方法参数将从提供程序流式传输回客户端。

MI_FLAG_BORROW (0x40000000)

MI_Instance 上添加和设置属性时使用,以指示实例不会复制值。 在删除实例之前,该值必须保持有效。

MI_FLAG_ADOPT (0x80000000)

MI_Instance 上添加和设置属性时使用,以指示实例将采用指针并将负责删除它。

MI_FLAG_NULL (0x20000000)

元素值为 Null

MI_FLAG_ANY (0x0000007F)

用于筛选出其他标志的位掩码。

返回值

此函数返回MI_INLINE MI_Result MI_INLINE_CALL。

要求

   
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 mi.h
可再发行组件 windows Server 2008 R2 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 上的Windows Management Framework 3.0

另请参阅

MI_Instance_ClearElement

MI_Instance_GetElement

MI_Instance_SetElement