Compartilhar via


Método SWbemLastError.CompareTo_

O método CompareTo_ do objeto SWbemLastError 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. Um objeto da classe SWbemObject. Esse parâmetro é o objeto com o qual o primeiro objeto é comparado. O objeto deve ser uma instância do SWbemObject válida.

iFlags [entrada, opcional]

Um inteiro que especifica sinalizadores adicionais para a operação. Esse parâmetro especifica as características do objeto a serem consideradas quando são feitas comparações de objeto. Você pode usar wbemComparisonFlagIncludeAll para considerar todos os recursos (padrão) ou qualquer combinação dos valores a seguir.

wbemComparisonFlagIncludeAll (0 (0x0))

Faz com que todas as propriedades, qualificadores e variantes sejam comparados.

wbemComparisonFlagIgnoreQualifiers (1 (0x1))

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

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.

wbemComparisonFlagIgnoreDefaultValues (4 (0x4))

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

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.

wbemComparisonFlagIgnoreCase (16 (0x10))

Faz com que os valores de cadeia de caracteres sejam comparados de maneira sem diferenciar maiúsculas de 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.

wbemComparisonFlagIgnoreFlavor (32 (0x20))

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

Retornar valor

O método CompareTo_ retorna o valor booliano TRUE se os objetos corresponderem; caso contrário, retornará FALSE.

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_SWbemLastError
IID
IID_ISWbemLastError

Confira também

SWbemLastError

SWbemObject