iColumnData::GetColumnSortData 方法 (mmc.h)

IColumnData::GetColumnSortData 方法使管理单元能够从内存中检索列集中列的排序和排序方向。

语法

HRESULT GetColumnSortData(
  [in]  SColumnSetID      *pColID,
  [out] MMC_SORT_SET_DATA **ppColSortData
);

parameters

[in] pColID

指向 SColumnSetID 结构的指针,该结构包含要检索其排序数据的列集的 ID。

[out] ppColSortData

指向 MMC_SORT_SET_DATA结构的指针 的指针,该结构将包含列集的列排序数据。

返回值

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

注解

如果用户选择范围项,然后修改所选项的列表视图的排序数据。 如果管理单元调用 IColumnData::GetColumnSortData 来检索相同的排序数据,则无论用户是否已取消选择该项,方法都将返回新数据。

MMC_SORT_SET_DATA 结构及其MMC_SORT_DATA结构数组在调用 GetColumnSortData 期间由 MMC 分配为一个连续内存块。 管理单元必须使用指向 MMC_SORT_SET_DATA的给定指针调用 CoTaskMemFree。 这会释放整个内存块。

由 IColumnData 接口的方法检索的所有数据集都由 MMC 保留在内存中,而不是保存在流或存储介质中。 仅当用户选择“ 保存 ”菜单命令时,此数据才会保存到 .msc 控制台文件中。

要求

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

另请参阅

IColumnData

使用 IColumnData