通过

MI_Instance_SetElement 函数 (mi.h)

  • 项目

在给定实例中使用给定名称设置 元素的值。

语法

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

参数

[out] self

指向实例的指针。

name

一个以 null 结尾的字符串，表示将设置的元素的名称。

[in, optional] value

元素的新值。

type

要设置的元素的 CIM 类型。

flags

指示内存管理策略的位标志。

MI_FLAG_BORROW

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

MI_FLAG_ADOPT

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

MI_FLAG_NULL

元素值为 Null。

返回值

此函数返回MI_INLINE MI_Result MI_INLINE_CALL。

注解

默认情况下，复制值参数引用的所有内存。 通过将 标志MI_FLAG_BORROW传递，值结构中的内存指针直接存储在实例的 元素中。 调用方必须保证内存的运行期大于实例。

要求

要求 值
最低受支持的客户端 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