Compartilhar via

Método IResultDataCompareEx::Compare (mmc.h)

  • Artigo

O método IResultDataCompareEx::Compare fornece uma maneira de um snap-in primário comparar itens com a finalidade de classificar o escopo e os itens de resultado que ele insere no painel de resultados.

Sintaxe

HRESULT Compare(
  [in]  RDCOMPARE *prdc,
  [out] int       *pnResult
);

Parâmetros

[in] prdc

Um ponteiro para uma estrutura RDCOMPARE que contém informações sobre os itens que estão sendo comparados e qual coluna no modo de exibição de lista do painel de resultados está sendo classificada.

[out] pnResult

O snap-in deve definir pnResult como o resultado da comparação:

  • Qualquer inteiro negativo se o item 1 < item 2
  • Zero (0) se o item 1 == item 2
  • Qualquer inteiro positivo se o item 1 > item 2

Valor retornado

Esse método pode retornar um desses valores.

Comentários

Compare fornece um mecanismo para determinar a ordem de classificação de objetos de escopo e item de resultado que aparecem no painel de resultados. A classificação interna fornecida pelo MMC usa apenas a função de comparação de cadeia de caracteres da biblioteca de tempo de execução C para comparar os dados. Se essa interface for implementada, ela será usada para todas as comparações.

A comparação deve ser baseada em uma ordem de classificação crescente. Se o usuário alternar o cabeçalho de exibição de resultado padrão, o console complementará os resultados de comparação, o que resultará em uma ordem de classificação decrescente.

A interface IResultDataCompareEx não é chamada para classificação de lista virtual. Isso ocorre porque o snap-in mantém todo o armazenamento de dados de item para uma lista virtual, o snap-in deve classificar os itens em si. Um snap-in deve implementar a interface IResultOwnerData para fornecer classificação para listas virtuais.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho mmc.h