MI_Instance_AddElement-Funktion (mi.h)

Fügt einer dynamischen instance eine neue Eigenschaft hinzu (wird nur von dynamischen Instanzen unterstützt, deren Schema zur Laufzeit erweitert werden kann).

Syntax

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

Parameter

[in, out] self

Instanz, der das Element hinzugefügt wird.

name

Eine NULL-endende Zeichenfolge, die den Namen des neuen Elements darstellt.

[in, optional] value

Elementwert.

type

Elementtyp.

flags

Flags des neuen Elements, die eine Kombination der folgenden Flagwerte sein können.

MI_FLAG_KEY (0x00001000)

Das Element ist ein Schlüssel.

MI_FLAG_IN (0x00002000)

Der Parameter hat den Typ In und wird an eine -Methode übergeben.

MI_FLAG_OUT (0x00004000)

Der Parameter hat den Typ Out und wird von einer -Methode zurückgegeben.

MI_FLAG_REQUIRED (0x00008000)

Parameter ist erforderlich.

MI_FLAG_STREAM (0x00100000)

Der Methodenparameter wird vom Anbieter zurück an den Client gestreamt.

MI_FLAG_BORROW (0x40000000)

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

MI_FLAG_ADOPT (0x80000000)

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 (0x20000000)

Der Elementwert ist Null.

MI_FLAG_ANY (0x0000007F)

Bitmaske, die verwendet wird, um andere Flags herauszufiltern.

Rückgabewert

Diese Funktion gibt MI_INLINE MI_Result MI_INLINE_CALL zurück.

Anforderungen

Weitere Informationen

MI_Instance_ClearElement

MI_Instance_GetElement

MI_Instance_SetElement