Partilhar via

Função CompareTo

  • Artigo

Compara um objeto a outro objeto de gestão do Windows.

Nota

Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.

Sintaxe

HRESULT CompareTo (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              flags,
   [in] IWbemClassObject* pCompareTo
);

Parâmetros

vFunc
[in] Este parâmetro não é utilizado.

ptr
[in] Um ponteiro para uma instância IWbemClassObject .

flags
[in] Uma combinação bit-a-bit dos sinalizadores que especificam as características do objeto a considerar para a comparação. Consulte a secção Observações para obter mais informações.

pCompareTo
[in] O objeto para comparação. pCompareTo tem de ser uma instância IWbemClassObject válida; não pode ser null.

Valor devolvido

Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código:

Constante Valor Descrição
WBEM_E_FAILED 0x80041001 Ocorreu um erro não especificado.
WBEM_E_INVALID_PARAMETER 0x80041008 Um parâmetro é inválido.
WBEM_E_UNEXPECTED 0x8004101d Uma segunda chamada para BeginEnumeration foi feita sem uma chamada interveniente para EndEnumeration.
WBEM_S_NO_ERROR 0 A chamada da função foi efetuada com êxito.
WBEM_S_DIFFERENT 0x40003 Os objetos são diferentes.
WBEM_S_SAME 0 Os objetos são os mesmos com base nos sinalizadores de comparação.

Observações

Esta função encapsula uma chamada para o método IWbemClassObject::CompareTo .

Os sinalizadores que podem ser transmitidos como o lEnumFlags argumento são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código. Pode especificar as características individuais envolvidas na comparação ao especificar uma combinação bit-a-bit dos seguintes sinalizadores:

Constante Valor Descrição
WBEM_FLAG_IGNORE_OBJECT_SOURCE 2 Ignore a origem (o servidor e o espaço de nomes de onde vieram).
WBEM_FLAG_IGNORE_QUALIFIERS 1 Ignorar todos os qualificadores (incluindo Chave e Dinâmica)
WBEM_FLAG_IGNORE_DEFAULT_VALUES 4 Ignorar valores predefinidos de propriedades. Este sinalizador aplica-se apenas à comparação de classes.
WBEM_FLAG_IGNORE_FLAVOR 0x20 Ignore os sabores de qualificação. Este sinalizador ainda tem em conta os qualificadores, mas ignora distinções de sabor, como regras de propagação e restrições de substituição.
WBEM_FLAG_IGNORE_CASE 0x10 Ignorar maiúsculas/minúsculas na comparação de valores de cadeia. Isto aplica-se tanto a cadeias como a valores de qualificação. A comparação de nomes de propriedades e qualificadores é sempre sensível às maiúsculas e minúsculas, independentemente de este sinalizador estar definido.
WBEM_FLAG_IGNORE_CLASS 0x8 Suponha que os objetos que estão a ser comparados são instâncias da mesma classe. Consequentemente, este sinalizador compara apenas informações relacionadas com instâncias. Utilize estes sinalizadores para otimizar o desempenho. Se os objetos não forem da mesma classe, os resultados são indefinidos.

Em alternativa, pode especificar um único sinalizador composto da seguinte forma:

Constante Valor Descrição
WBEM_COMPARISON_INCLUDE_ALL 0 Considere todas as funcionalidades na comparação.

Requisitos

Plataformas: Veja Requisitos de Sistema.

Cabeçalho: WMINet_Utils.idl

.NET Framework Versões: Disponível desde a versão 4.7.2

Ver também