Compartilhar via


função MI_Instance_AddElement (mi.h)

Adiciona uma nova propriedade a uma instância dinâmica (compatível apenas com instâncias dinâmicas cujo esquema pode ser estendido em tempo de execução).

Sintaxe

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

Instância à qual o elemento será adicionado.

name

Uma cadeia de caracteres terminada em nulo que representa o nome do novo elemento.

[in, optional] value

Valor do elemento.

type

Tipo de elemento.

flags

Sinalizadores do novo elemento que pode ser uma combinação dos valores de sinalizador a seguir.

MI_FLAG_KEY (0x00001000)

O elemento é uma chave.

MI_FLAG_IN (0x00002000)

O parâmetro é do tipo In e é passado para um método .

MI_FLAG_OUT (0x00004000)

O parâmetro é do tipo Out e é retornado de um método .

MI_FLAG_REQUIRED (0x00008000)

O parâmetro é necessário.

MI_FLAG_STREAM (0x00100000)

O parâmetro de método será transmitido de volta para o cliente do provedor.

MI_FLAG_BORROW (0x40000000)

Usado ao adicionar e definir propriedades em um MI_Instance para indicar que a instância não copiará o valor. O valor deve permanecer válido até que a instância seja excluída.

MI_FLAG_ADOPT (0x80000000)

Usado ao adicionar e definir propriedades em um MI_Instance para indicar que a instância adotará o ponteiro e será responsável por excluí-lo.

MI_FLAG_NULL (0x20000000)

O valor do elemento é Null.

MI_FLAG_ANY (0x0000007F)

Máscara de bits usada para filtrar outros sinalizadores.

Valor retornado

Essa função retorna MI_INLINE MI_Result MI_INLINE_CALL.

Requisitos

   
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho mi.h
Redistribuível Windows Management Framework 3.0 no Windows Server 2008 R2 com SP1, Windows 7 com SP1 e Windows Server 2008 com SP2

Confira também

MI_Instance_ClearElement

MI_Instance_GetElement

MI_Instance_SetElement