MI_Instance_SetElement función (mi.h)

Establezca el valor del elemento con el nombre especificado en la instancia especificada.

Sintaxis

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

Parámetros

[out] self

Puntero a una instancia de .

name

Cadena terminada en null que representa el nombre del elemento que se establecerá.

[in, optional] value

Nuevo valor para el elemento .

type

Tipo CIM del elemento que se establecerá.

flags

Marcas de bits que indican la directiva de administración de memoria.

MI_FLAG_BORROW

Se usa al agregar y establecer propiedades en un MI_Instance para indicar que la instancia no copiará el valor. El valor debe permanecer válido hasta que se elimine la instancia.

MI_FLAG_ADOPT

Se usa al agregar y establecer propiedades en un MI_Instance para indicar que la instancia adoptará el puntero y será responsable de eliminarla.

MI_FLAG_NULL

El valor del elemento es Null.

Valor devuelto

Esta función devuelve MI_INLINE MI_Result MI_INLINE_CALL.

Comentarios

De forma predeterminada, se copia toda la memoria a la que hace referencia el parámetro value. Al pasar la marca MI_FLAG_BORROW, los punteros de memoria dentro de la estructura de valores se almacenan directamente en el elemento de la instancia. El autor de la llamada debe garantizar que la memoria sobrevive a la instancia.

Requisitos