Método SWbemPropertySet.Add

O método Add do objeto SWbemPropertySet adiciona um objeto SWbemProperty à coleção SWbemPropertySet. Se uma propriedade com o mesmo nome já existir na coleção, seu conteúdo será substituído pela nova definição.

Para obter uma explicação dessa sintaxe, confira Convenções de documentação para a API de Script.

Sintaxe

objProperty = .Add( _
  ByVal strName, _
  ByVal iCIMType, _
  [ ByVal bIsArray ], _
  [ ByVal iFlags ] _
)

Parâmetros

strName [in]

Obrigatórios. Nome da nova propriedade.

iCIMType [in]

Obrigatórios. Um inteiro que representa o qualificador CIMType da nova propriedade. Confira WbemCimTypeEnum para obter a lista com os qualificadores CIMType e seus valores.

bIsArray [in, opcional]

Especifica se a propriedade é um tipo de matriz. O valor padrão para esse parâmetro é FALSE.

iFlags [in, opcional]

Reservado e deve ser zero se especificado.

Retornar valor

Se tiver êxito, este método retornará um objeto SWbemProperty que representa a nova propriedade. Caso contrário, um objeto null será retornado.

Códigos do Erro

Após a conclusão do método Add, o objeto Err poderá conter um dos códigos de erro abaixo.

wbemErrFailed – 2147749889 (0x80041001)

Falha não especificada.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Foi especificado um parâmetro inválido.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Memória insuficiente para executar esse método.

wbemErrInvalidPropertyType – 2147749930

O qualificador CIMType não é reconhecido.

Exemplos

Para obter um exemplo de código que use esse método, confira o tópico SWbemPropertySet.

Requisitos

Confira também

SWbemPropertySet

SWbemPropertySet.Remove

SWbemProperty.Value