iColumnData::GetColumnConfigData 方法 (mmc.h)

IColumnData::GetColumnConfigData 方法使管理单元能够检索 MMC 存储在内存中的列集中每个列的当前宽度、顺序和隐藏状态。

语法

HRESULT GetColumnConfigData(
  [in]  SColumnSetID        *pColID,
  [out] MMC_COLUMN_SET_DATA **ppColSetData
);

参数

[in] pColID

指向 SColumnSetID 结构的指针,该结构保存要检索其数据的列集的 ID。

[out] ppColSetData

指向 MMC_COLUMN_SET_DATA结构的指针 的指针,该结构将保存检索到的列数据。

返回值

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

注解

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

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

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

要求

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

另请参阅

IColumnData

使用 IColumnData