Метод IResultDataCompareEx::Compare (mmc.h)

Метод IResultDataCompareEx::Compare предоставляет основной оснастке способ сравнения элементов с целью сортировки область и результирующих элементов, которые она вставляет в область результатов.

Синтаксис

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

Параметры

[in] prdc

Указатель на структуру RDCOMPARE , которая содержит сведения о сравниваемых элементах и о том, какой столбец в представлении списка области результатов сортируется.

[out] pnResult

Оснастка должна задать для pnResult результат сравнения:

• Любое отрицательное целое число, если элемент 1 < , элемент 2
• Ноль (0), если элемент 1 == элемент 2
• Любое положительное целое число, если элемент 1 > , элемент 2

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Комментарии

Функция сравнения предоставляет механизм для определения порядка сортировки объектов область и результирующих элементов, отображаемых на панели результатов. Встроенная сортировка, предоставляемая MMC, использует только функцию сравнения строк библиотеки времени выполнения C для сравнения данных. Если этот интерфейс реализован, он используется для всех сравнений.

Сравнение должно основываться на порядке сортировки по возрастанию. Если пользователь переключает стандартный заголовок представления результатов, консоль дополняет результаты сравнения, что приводит к убыванию порядка сортировки.

Интерфейс IResultDataCompareEx не вызывается для сортировки виртуальных списков. Это связано с тем, что оснастка поддерживает все хранилище данных элементов для виртуального списка, оснастка должна отсортировать сами элементы. Оснастка должна реализовывать интерфейс IResultOwnerData для обеспечения сортировки виртуальных списков.

Требования

Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	mmc.h