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

El método IResultDataCompareEx::Compare proporciona una manera de que un complemento principal compare los elementos con el fin de ordenar el ámbito y los elementos de resultado que inserta en el panel de resultados.

Sintaxis

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

Parámetros

[in] prdc

Puntero a una estructura RDCOMPARE que contiene información sobre los elementos que se comparan y qué columna de la vista de lista del panel de resultados se está ordenando.

[out] pnResult

El complemento debe establecer pnResult en el resultado de la comparación:

• Entero negativo si el elemento 1 < elemento 2
• Cero (0) si el elemento 1 == elemento 2
• Entero positivo si el elemento 1 > elemento 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 ámbito y 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 la interfaz IResultDataCompareEx para la ordenación de listas virtuales. Esto se debe a 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