fonction MI_Instance_SetElement (mi.h)

Définissez la valeur de l’élément avec le nom donné dans le instance donné.

Syntaxe

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

Paramètres

[out] self

Pointeur vers un instance.

name

Chaîne terminée par null qui représente le nom de l’élément qui sera défini.

[in, optional] value

Nouvelle valeur de l’élément.

type

Type CIM de l’élément qui sera défini.

flags

Indicateurs de bits indiquant la stratégie de gestion de la mémoire.

MI_FLAG_BORROW

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 le instance soit supprimé.

MI_FLAG_ADOPT

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

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

Valeur retournée

Cette fonction retourne MI_INLINE MI_Result MI_INLINE_CALL.

Remarques

Par défaut, toute la mémoire référencée par le paramètre value est copiée. En passant l’indicateur MI_FLAG_BORROW, les pointeurs de mémoire dans la structure de valeurs sont stockés directement dans l’élément du instance. L’appelant doit garantir que la mémoire survive à l’instance.

Configuration requise