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
);

parameters

[in] lUserParam

一个 值,该值指定传递到 IResultData::Sort 中的用户提供的信息。 MMC 不解释此参数。

[in] cookieA

要作为排序操作的一部分进行比较的第一个结果项对象的唯一标识符。

[in] cookieB

要作为排序操作的一部分进行比较的第二个结果项对象的唯一标识符。

[in, out] pnResult

作为 in 参数,参数包含排序的列。 作为 out 参数,参数的值应为:

  • -1 如果项目 1 < 项 2
  • 如果项 1 == 项 2,则零 (0)
  • 如果项目 1 项 2,则为 1 >

返回值

此方法可以返回其中一个值。

注解

Compare 提供了一种机制,用于确定结果窗格中显示的结果项对象的排序顺序。 MMC 提供的内置排序仅使用 C 运行时库 string-compare 函数来比较数据。 如果实现此接口,它将用于所有比较。

比较应基于升序排序顺序。 如果用户切换标准结果视图标头,控制台会补充比较结果,从而按降序排序。

对于虚拟列表排序,不调用此 IResultDataCompare 接口。 由于管理单元维护虚拟列表的所有项数据存储,因此管理单元必须对项本身进行排序。 管理单元必须实现 IResultOwnerData 接口才能为虚拟列表提供排序。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h

另请参阅

IResultData::Sort

IResultOwnerData::SortItems