MI_Instance_SetElement-Funktion (mi.h)

Legen Sie den Wert des Elements mit dem angegebenen Namen in der angegebenen instance fest.

Syntax

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
);

Parameter

[out] self

Ein Zeiger auf eine instance.

name

Eine NULL-Zeichenfolge, die den Namen des Elements darstellt, das festgelegt wird.

[in, optional] value

Der neue Wert für das -Element.

type

Der CIM-Typ des Elements, das festgelegt wird.

flags

Bitflags, die die Speicherverwaltungsrichtlinie angeben.

MI_FLAG_BORROW

Wird beim Hinzufügen und Festlegen von Eigenschaften für eine MI_Instance verwendet, um anzugeben, dass der instance den Wert nicht kopiert. Der Wert muss gültig bleiben, bis der instance gelöscht wird.

MI_FLAG_ADOPT

Wird beim Hinzufügen und Festlegen von Eigenschaften für eine MI_Instance verwendet, um anzugeben, dass der instance den Zeiger übernimmt und für das Löschen verantwortlich ist.

MI_FLAG_NULL

Der Elementwert ist NULL.

Rückgabewert

Diese Funktion gibt MI_INLINE MI_Result MI_INLINE_CALL zurück.

Hinweise

Standardmäßig wird der gesamte Arbeitsspeicher, auf den der Wertparameter verweist, kopiert. Durch Übergeben des Flags MI_FLAG_BORROW werden Speicherzeiger innerhalb der Wertstruktur direkt im Element des instance gespeichert. Der Aufrufer muss sicherstellen, dass der Speicher den instance überdauert.

Anforderungen