Método SWbemQualifierSet.Add

Artigo
07/03/2023

O método Adicionar do objeto SWbemQualifierSet adiciona um objeto SWbemQualifier à coleção SWbemQualifierSet. Se um qualificador com o mesmo nome já existir na coleção, ele será substituído.

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

Sintaxe

objQualifier = .Add( _
  ByVal strName, _
  ByVal varVal, _
  [ ByVal bPropagatesToSubclasses ], _
  [ ByVal bPropagatesToInstances ], _
  [ ByVal bOverridable ], _
  [ ByVal iFlags ] _
)

Parâmetros

strName [in]: Obrigatórios. Nome do novo qualificador.
varVal [entrada]: Obrigatórios. Valor variante do novo qualificador.
bPropagatesToSubclasses [entrada, opcional]: Valor booliano que indica se esse novo qualificador é propagado para subclasses. O valor padrão é TRUE.
bPropagatesToInstances [entrada, opcional]: Valor booliano que indica se esse novo qualificador é propagado para instâncias. O valor padrão é TRUE.
bOverridable [entrada, opcional]: Valor booliano que indica se esse qualificador pode ser substituído quando propagado. O valor padrão é TRUE.
iFlags [entrada, opcional]: Reservado. O valor padrão é 0.

Retornar valor

Se tiver êxito, este método retornará um objeto SWbemQualifier que representa o novo qualificador. Caso contrário, um objeto nulo será retornado.

Códigos do Erro

Após a conclusão do método Adicionar, o objeto de Erro pode conter um dos códigos de erro da lista a seguir.

wbemErrInvalidParameter - 2147749896 (0x80041008): O parâmetro iFlags não era válido.
wbemErrFailed – 2147749889 (0x80041001): Erro não especificado.
wbemErrCannotBeKey - 2147749919 (0x8004101F): Houve uma tentativa inválida de especificar um qualificador Chave em uma propriedade que não pode ser uma chave. As chaves são especificadas na definição de classe para um objeto e não podem ser alteradas por instância.
wbemErrInvalidQualifierType - 2147749929 (0x80041029): O parâmetro varVal não é de um tipo de qualificador válido.
wbemErrOverrideNotAllowed - 2147749914 (0x8004101A): Não é possível executar a operação SWbemQualifierSet.Add neste qualificador porque o objeto de propriedade não permite substituições.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemQualifierSet
IID	IID_ISWbemQualifierSet

Confira também

SWbemQualifierSet
SWbemQualifierSet.Remove

Share via