Método IColumnData::GetColumnSortData (mmc.h)
O método IColumnData::GetColumnSortData permite que um snap-in recupere da memória a coluna classificada e a direção de classificação para colunas em um conjunto de colunas.
Sintaxe
HRESULT GetColumnSortData(
[in] SColumnSetID *pColID,
[out] MMC_SORT_SET_DATA **ppColSortData
);
Parâmetros
[in] pColID
Um ponteiro para uma estrutura SColumnSetID que contém a ID do conjunto de colunas cujos dados de classificação devem ser recuperados.
[out] ppColSortData
Um ponteiro para um ponteiro para uma estrutura MMC_SORT_SET_DATA que conterá os dados de classificação de coluna do conjunto de colunas.
Valor retornado
Esse método pode retornar um desses valores.
Comentários
Se o usuário selecionar um item de escopo e modificar os dados de classificação da exibição de lista do item selecionado. Se o snap-in chamar IColumnData::GetColumnSortData para recuperar os mesmos dados de classificação, o método retornará os novos dados, independentemente de o usuário ter desmarcado o item ou não.
A estrutura MMC_SORT_SET_DATA e sua matriz de estruturas MMC_SORT_DATA são alocadas como um bloco de memória contíguo pelo MMC durante chamadas para GetColumnSortData. O snap-in deve chamar CoTaskMemFree com o ponteiro fornecido para MMC_SORT_SET_DATA. Isso libera todo o bloco de memória.
Todo o conjunto de dados e recuperados pelos métodos da interface IColumnData é persistido pelo MMC na memória e não em um fluxo ou meio de armazenamento. Esses dados são persistidos em um arquivo de console .msc somente quando o usuário escolhe o comando de menu Salvar .
Requisitos
| 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 |