Compartilhar via


Método IColumnData::SetColumnSortData (mmc.h)

O método IColumnData::SetColumnSortData permite que um snap-in defina a coluna classificada e a direção de classificação para colunas em um conjunto de colunas.

Sintaxe

HRESULT SetColumnSortData(
  [in] SColumnSetID      *pColID,
  [in] MMC_SORT_SET_DATA *pColSortData
);

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 definidos.

[in] pColSortData

Um ponteiro para uma estrutura MMC_SORT_SET_DATA que contém os dados de classificação de coluna do conjunto de colunas.

Retornar valor

Esse método pode retornar um desses valores.

Comentários

Se o usuário selecionar um item de escopo e o snap-in chamar IColumnData::SetColumnSortData para modificar os dados de classificação da exibição de lista do item selecionado. O MMC aplicará as alterações à exibição de lista somente depois que o usuário tiver desmarcado e, em seguida, reelecionado o item. Lembre-se de que o MMC também aplica as alterações a todos os conjuntos de colunas com a mesma ID, portanto, se o usuário selecionar um item diferente com a mesma ID do conjunto de colunas, o MMC também aplicará os dados persistentes a ele.

O MMC 1.2 dá suporte apenas à classificação de coluna única, razão pela qual SetColumnSortData retorna E_FAIL quando o número de colunas de classificação é maior que 1.

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 persistidos em um arquivo de console .msc somente quando o usuário escolhe o 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

Confira também

IColumnData

Usando IColumnData