función MI_Instance_AddElement (mi.h)

Agrega una nueva propiedad a una instancia dinámica (solo compatible con instancias dinámicas cuyo esquema se puede extender en tiempo de ejecución).

Sintaxis

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

Parámetros

[in, out] self

Instancia a la que se agregará el elemento.

name

Cadena terminada en null que representa el nombre del nuevo elemento.

[in, optional] value

Valor de elemento.

type

Tipo de elemento.

flags

Marcas del nuevo elemento que pueden ser una combinación de los siguientes valores de marca.

MI_FLAG_KEY (0x00001000)

El elemento es una clave.

MI_FLAG_IN (0x00002000)

El parámetro es de tipo In y se pasa a un método .

MI_FLAG_OUT (0x00004000)

El parámetro es de tipo Out y se devuelve de un método .

MI_FLAG_REQUIRED (0x00008000)

Se requiere el parámetro .

MI_FLAG_STREAM (0x00100000)

El parámetro de método se volverá a transmitir al cliente desde el proveedor.

MI_FLAG_BORROW (0x40000000)

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

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

El valor del elemento es Null.

MI_FLAG_ANY (0x0000007F)

Máscara de bits usada para filtrar otras marcas.

Valor devuelto

Esta función devuelve MI_INLINE MI_Result MI_INLINE_CALL.

Requisitos

Consulte también

MI_Instance_ClearElement

MI_Instance_GetElement

MI_Instance_SetElement