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 |