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

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

Метод IResultDataCompare::Compare нельзя использовать для область элементов. Однако эта функция предоставляется методом IResultDataCompareEx::Compare .

Синтаксис

HRESULT Compare(
  [in]      LPARAM     lUserParam,
  [in]      MMC_COOKIE cookieA,
  [in]      MMC_COOKIE cookieB,
  [in, out] int        *pnResult
);

Параметры

[in] lUserParam

Значение типа , указывающее предоставленные пользователем сведения, передаваемые в IResultData::Sort. MMC не интерпретирует этот параметр.

[in] cookieA

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

[in] cookieB

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

[in, out] pnResult

В качестве параметра in аргумент содержит отсортированный столбец. В качестве параметра out аргумент должен иметь следующее значение:

• -1, если элемент 1 < элемент 2
• ноль (0), если элемент 1 == элемент 2
• 1, если элемент 1 > элемент 2

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

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

Комментарии

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

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

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

Требования

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

См. также раздел

IResultData::Sort

IResultOwnerData::SortItems