função MI_Instance_SetElement (mi.h)

Defina o valor do elemento com o nome fornecido na instância fornecida.

Sintaxe

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

Um ponteiro para uma instância.

name

Uma cadeia de caracteres terminada em nulo que representa o nome do elemento que será definido.

[in, optional] value

O novo valor para o elemento .

type

O tipo CIM do elemento que será definido.

flags

Sinalizadores de bits que indicam a política de gerenciamento de memória.

MI_FLAG_BORROW

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

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

O valor do elemento é Null.

Retornar valor

Essa função retorna MI_INLINE MI_Result MI_INLINE_CALL.

Comentários

Por padrão, toda a memória referenciada pelo parâmetro value é copiada. Ao passar o sinalizador MI_FLAG_BORROW, os ponteiros de memória dentro da estrutura de valor são armazenados diretamente no elemento da instância. O chamador deve garantir que a memória sobreviva à instância.

Requisitos

Requisito	Valor
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