Método IColumnData::GetColumnConfigData (mmc.h)
O método IColumnData::GetColumnConfigData permite que um snap-in recupere a largura, a ordem e as status ocultas atuais de cada coluna em um conjunto de colunas armazenado na memória pelo MMC.
Sintaxe
HRESULT GetColumnConfigData(
[in] SColumnSetID *pColID,
[out] MMC_COLUMN_SET_DATA **ppColSetData
);
Parâmetros
[in] pColID
Um ponteiro para uma estrutura SColumnSetID que contém a ID do conjunto de colunas cujos dados devem ser recuperados.
[out] ppColSetData
Um ponteiro para um ponteiro para uma estrutura MMC_COLUMN_SET_DATA que conterá os dados de coluna recuperados.
Retornar valor
Esse método pode retornar um desses valores.
Comentários
Suponha que o usuário selecione um item de escopo e modifique os dados de configuração de coluna da exibição de lista do item selecionado. Se o snap-in chamar IColumnData::GetColumnConfigData para recuperar os dados de configuração de coluna dessa exibição de lista, o método retornará os novos dados, independentemente de o usuário ter ou não desmarcado o item.
A estrutura MMC_COLUMN_SET_DATA e sua matriz de estruturas de MMC_COLUMN_DATA são alocados como um bloco de memória contíguo pelo MMC durante chamadas para GetColumnConfigData. O snap-in deve chamar CoTaskMemFree com o ponteiro fornecido para MMC_COLUMN_SET_DATA. Isso libera todo o bloco de memória.
Todos os conjuntos de dados e recuperados pelos métodos da interface IColumnData são persistidos pelo MMC na memória e não em um meio de fluxo ou armazenamento. Esses dados são salvos em um . Arquivo de console do MSC somente quando o usuário clica no comando de menu Salvar .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| DLL | Mmcndmgr.dll |