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

El método IColumnData::GetColumnSortData permite que un complemento recupere de la memoria la columna ordenada y la dirección de ordenación de las columnas de un conjunto de columnas.

Sintaxis

HRESULT GetColumnSortData(
  [in]  SColumnSetID      *pColID,
  [out] MMC_SORT_SET_DATA **ppColSortData
);

Parámetros

[in] pColID

Puntero a una estructura SColumnSetID que contiene el identificador del conjunto de columnas cuyos datos de ordenación se van a recuperar.

[out] ppColSortData

Puntero a un puntero a una estructura de MMC_SORT_SET_DATA que contendrá los datos de ordenación de columnas del conjunto de columnas.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

Si el usuario selecciona un elemento de ámbito y, a continuación, modifica los datos de ordenación de la vista de lista del elemento seleccionado. Si el complemento llama a IColumnData::GetColumnSortData para recuperar los mismos datos de ordenación, el método devolverá los nuevos datos, independientemente de si el usuario ha deseleccionado el elemento o no.

La estructura de MMC_SORT_SET_DATA y su matriz de estructuras de MMC_SORT_DATA se asignan como un bloque de memoria contiguo por MMC durante las llamadas a GetColumnSortData. El complemento debe llamar a CoTaskMemFree con el puntero especificado para MMC_SORT_SET_DATA. Esto libera todo el bloque de memoria.

Todos los conjuntos de datos y recuperados por los métodos de la interfaz IColumnData se conservan mediante MMC en memoria y no en un flujo o medio de almacenamiento. Estos datos se conservan en un archivo de consola .msc solo cuando el usuario elige el comando de menú Guardar .

Requisitos

Consulte también

IColumnData

Uso de IColumnData