MI_Instance_AddElement, fonction (mi.h)

Ajoute une nouvelle propriété à un instance dynamique (pris en charge uniquement par les instances dynamiques dont le schéma peut être étendu au moment de l’exécution).

Syntaxe

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

Paramètres

[in, out] self

Instance à laquelle l’élément sera ajouté.

name

Chaîne terminée par null qui représente le nom du nouvel élément.

[in, optional] value

Valeur de l’élément.

type

Type d’élément.

flags

Indicateurs du nouvel élément qui peuvent être une combinaison des valeurs d’indicateur suivantes.

MI_FLAG_KEY (0x00001000)

L’élément est une clé.

MI_FLAG_IN (0x00002000)

Le paramètre est de type In et est passé dans une méthode.

MI_FLAG_OUT (0x00004000)

Le paramètre est de type Out et est retourné à partir d’une méthode .

MI_FLAG_REQUIRED (0x00008000)

Le paramètre est obligatoire.

MI_FLAG_STREAM (0x00100000)

Le paramètre de méthode est retranstransé vers le client à partir du fournisseur.

MI_FLAG_BORROW (0x40000000)

Utilisé lors de l’ajout et de la définition de propriétés sur un MI_Instance pour indiquer que le instance ne copiera pas la valeur. La valeur doit rester valide jusqu’à ce que la instance soit supprimée.

MI_FLAG_ADOPT (0x80000000)

Utilisé lors de l’ajout et de la définition de propriétés sur un MI_Instance pour indiquer que le instance adoptera le pointeur et sera responsable de sa suppression.

MI_FLAG_NULL (0x20000000)

La valeur de l’élément est Null.

MI_FLAG_ANY (0x0000007F)

Masque de bits utilisé pour filtrer d’autres indicateurs.

Valeur retournée

Cette fonction retourne MI_INLINE MI_Result MI_INLINE_CALL.

Spécifications

Voir aussi

MI_Instance_ClearElement

MI_Instance_GetElement

MI_Instance_SetElement