IColumnData::GetColumnConfigData メソッド (mmc.h)
IColumnData::GetColumnConfigData メソッドを使用すると、MMC によってメモリに格納されている列セット内の各列の現在の幅、順序、および非表示の状態をスナップインで取得できます。
構文
HRESULT GetColumnConfigData(
[in] SColumnSetID *pColID,
[out] MMC_COLUMN_SET_DATA **ppColSetData
);
パラメーター
[in] pColID
データを取得する列セットの ID を保持する SColumnSetID 構造体へのポインター。
[out] ppColSetData
取得した列データを保持する MMC_COLUMN_SET_DATA 構造体へのポインター。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
注釈
ユーザーがスコープ アイテムを選択し、選択したアイテムのリスト ビューの列構成データを変更するとします。 スナップインが IColumnData::GetColumnConfigData を呼び出してリスト ビューの列構成データを取得する場合、ユーザーがアイテムを選択解除したかどうかにかかわらず、メソッドは新しいデータを返します。
MMC_COLUMN_SET_DATA構造体とそのMMC_COLUMN_DATA構造体の配列は、GetColumnConfigData の呼び出し中に MMC によって 1 つの連続したメモリ ブロックとして割り当てられます。 スナップインは、指定されたポインターを使用して CoTaskMemFree を呼び出 MMC_COLUMN_SET_DATA必要があります。 これにより、メモリ ブロック全体が解放されます。
IColumnData インターフェイスのメソッドによって取得されるすべてのデータ セットは、ストリームまたはストレージ メディアではなく、MMC によってメモリに保持されます。 このデータは に保存されます。MSC コンソール ファイルは、ユーザーが [保存] メニュー コマンドをクリックした場合にのみ発生します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | mmc.h |
| [DLL] | Mmcndmgr.dll |