Método IResultDataCompare::Compare (mmc.h)
El método IResultDataCompare::Compare proporciona una manera de que un complemento principal compare las cookies con el fin de ordenar los elementos de resultado que inserta en el panel de resultados.
El método IResultDataCompare::Compare no se puede usar para los elementos de ámbito. Sin embargo, el método IResultDataCompareEx::Compare proporciona esta funcionalidad.
Sintaxis
HRESULT Compare(
[in] LPARAM lUserParam,
[in] MMC_COOKIE cookieA,
[in] MMC_COOKIE cookieB,
[in, out] int *pnResult
);
Parámetros
[in] lUserParam
Valor que especifica la información proporcionada por el usuario que se pasa a IResultData::Sort. MMC no interpreta este parámetro.
[in] cookieA
Identificador único del primer objeto de elemento de resultado que se va a comparar como parte de la operación de ordenación.
[in] cookieB
Identificador único del segundo objeto de elemento de resultado que se va a comparar como parte de la operación de ordenación.
[in, out] pnResult
Como en el parámetro , el argumento contiene la columna que se ordena. Como parámetro out, el valor del argumento debe ser:
- -1 si el elemento 1 < elemento 2
- cero (0) si el elemento 1 == elemento 2
- 1 si el elemento 1 > del artículo 2
Valor devuelto
Este método puede devolver uno de estos valores.
Comentarios
Compare proporciona un mecanismo para determinar el criterio de ordenación de los objetos de elemento de resultado que aparecen en el panel de resultados. La ordenación integrada proporcionada por MMC solo usa la función string-compare de la biblioteca en tiempo de ejecución de C para comparar los datos. Si se implementa esta interfaz, se usa para todas las comparaciones.
La comparación debe basarse en un criterio de ordenación ascendente. Si el usuario alterna el encabezado de vista de resultados estándar, la consola complementa los resultados de comparación, lo que da como resultado un criterio de ordenación descendente.
No se llama a esta interfaz IResultDataCompare para la ordenación de listas virtuales. Dado que el complemento mantiene todo el almacenamiento de datos de elementos para una lista virtual, el complemento debe ordenar los elementos en sí. Un complemento debe implementar la interfaz IResultOwnerData para proporcionar ordenación para las listas virtuales.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | mmc.h |