Método IWbemClassObject::CompareTo (wbemcli.h)

O método IWbemClassObject::CompareTo compara um objeto com outro objeto de Gerenciamento do Windows. Observe que há determinadas restrições nesse processo de comparação.

Sintaxe

HRESULT CompareTo(
  [in] long             lFlags,
  [in] IWbemClassObject *pCompareTo
);

Parâmetros

[in] lFlags

Especifica as características do objeto a serem consideradas em comparação com outro objeto. Pode ser WBEM_COMPARISON_INCLUDE_ALL considerar todos os recursos ou qualquer combinação desses sinalizadores.

WBEM_FLAG_IGNORE_OBJECT_SOURCE

Ignore a origem dos objetos, ou seja, o servidor e o namespace de onde eles vieram, em comparação com outros objetos.

WBEM_FLAG_IGNORE_QUALIFIERS

Ignore todos os qualificadores (incluindo Chave e Dinâmico) em comparação.

WBEM_FLAG_IGNORE_DEFAULT_VALUES

Ignorar os valores padrão das propriedades. Esse sinalizador só é significativo ao comparar classes.

WBEM_FLAG_IGNORE_FLAVOR

Ignorar os tipos de qualificador. Esse sinalizador ainda leva em conta os valores do qualificador, mas ignora distinções de sabor, como regras de propagação e restrições de substituição (para obter mais informações, consulte Variantes do Qualificador).

WBEM_FLAG_IGNORE_CASE

Compare valores de cadeia de caracteres de maneira que não diferencia 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.

WBEM_FLAG_IGNORE_CLASS

Considera 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.

[in] pCompareTo

Objeto em comparação. Esse ponteiro deve apontar para uma instância IWbemClassObject válida. Não pode ser NULL.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT. Para obter valores gerais de HRESULT , consulte Códigos de erro do sistema.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	wbemcli.h (include Wbemidl.h)
Biblioteca	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Confira também

IWbemClassObject

Variantes de qualificador

WBEM_COMPARISON_FLAG