共用方式為

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。

備註

根據預設，會複製 value 參數所參考的所有記憶體。 藉由傳遞旗標MI_FLAG_BORROW，值結構內的記憶體指標會直接儲存在實例的 元素中。 呼叫端必須保證記憶體大於 實例。

規格需求

需求 值
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
目標平台 Windows
標頭 mi.h
可轉散發套件 Windows Management Framework Windows Server 2008 R2 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 上的 3.0