Método IResultDataCompare::Compare (mmc.h)
O método IResultDataCompare::Compare fornece uma maneira de um snap-in primário comparar cookies com a finalidade de classificar os itens de resultado que ele insere no painel de resultados.
O método IResultDataCompare::Compare não pode ser usado para itens de escopo. No entanto, essa funcionalidade é fornecida pelo método IResultDataCompareEx::Compare .
Sintaxe
HRESULT Compare(
[in] LPARAM lUserParam,
[in] MMC_COOKIE cookieA,
[in] MMC_COOKIE cookieB,
[in, out] int *pnResult
);
Parâmetros
[in] lUserParam
Um valor que especifica informações fornecidas pelo usuário que são passadas para IResultData::Sort. O MMC não interpreta esse parâmetro.
[in] cookieA
O identificador exclusivo do primeiro objeto de item de resultado a ser comparado como parte da operação de classificação.
[in] cookieB
O identificador exclusivo do segundo objeto de item de resultado a ser comparado como parte da operação de classificação.
[in, out] pnResult
Como um parâmetro in, o argumento contém a coluna que é classificada. Como um parâmetro out, o valor do argumento deve ser:
- -1 se item 1 < item 2
- zero (0) se o item 1 == item 2
- 1 se 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 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.
Essa interface IResultDataCompare não é chamada para classificação de lista virtual. Como 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 |