Compartilhar via


Método SWbemObject.CompareTo_

O método CompareTo_ do objeto SWbemObject compara dois objetos SWbemObject. Essa comparação está sujeita a determinadas restrições com base nos valores especificados no parâmetro iFlags.

Para ver uma explicação dessa sintaxe, confira Convenções de documento para a API de script.

Sintaxe

bAreEqual = .CompareTo_( _
  ByVal objwbemObject, _
  [ ByVal iFlags ] _
)

Parâmetros

objwbemObject [in]

Obrigatórios. Esse parâmetro é um objeto SWbemObject. Esse é o objeto com o qual o primeiro objeto é comparado. O objeto deve ser uma instância do SWbemObject válida.

iFlags [in, opcional]

Especifica as características do objeto a serem consideradas ao comparar um objeto com outros objetos. Você pode usar wbemComparisonFlagIncludeAll para considerar todos os recursos (esse é o padrão) ou qualquer combinação dos valores a seguir.

wbemComparisonFlagIncludeAll (0 (0x0))

Compara todas as propriedades, qualificadores e variantes.

wbemComparisonFlagIgnoreObjectSource (2 (0x2))

Faz com que a origem dos objetos, ou seja, o servidor e o namespace dos quais eles vieram, sejam ignorados na comparação com outros objetos.

wbemComparisonFlagIgnoreQualifiers (1 (0x1))

Faz com que todos os qualificadores (incluindo Key e Dynamic) sejam ignorados na comparação.

wbemComparisonFlagIgnoreDefaultValues (4 (0x4))

Faz com que os valores padrão das propriedades sejam ignorados. Esse sinalizador só é significativo ao comparar classes.

wbemComparisonFlagIgnoreFlavor (32 (0x20))

Faz com que as variantes de qualificador sejam ignoradas. Este sinalizador considera valores de qualificador, mas ignora diferenças de tipo como regras de propagação e restrições de substituição.

wbemComparisonFlagIgnoreCase (16 (0x10))

Compara valores da cadeia de caracteres sem diferenciação de maiúsculas e minúsculas. Isso se aplica a cadeias de caracteres e a valores do qualificador. Nomes de propriedade e de qualificador sempre são comparados sem diferenciação de maiúsculas e minúsculas, seja este sinalizador especificado ou não.

wbemComparisonFlagIgnoreClass (8 (0x8))

Instrui o sistema a assumir que os objetos que estão sendo comparados são instâncias da mesma classe. Consequentemente, esse sinalizador compara somente informações relacionadas a instâncias. Use este sinalizador para otimizar o desempenho. Se os objetos não são da mesma classe, os resultados são indefinidos.

Retornar valor

Esse método retornará o valor booliano TRUE, se os objetos corresponderem. Ele retornará FALSE, se os objetos não corresponderem.

Códigos do Erro

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

wbemErrFailed – 2147749889 (0x80041001)

Erro não especificado.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Um parâmetro especificado não é válido.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Não há memória suficiente para concluir a operação.

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_SWbemObject
IID
IID_ISWbemObject

Confira também

SWbemObject