IColumnData::GetColumnSortData-Methode (mmc.h)

Die IColumnData::GetColumnSortData-Methode ermöglicht es einem Snap-In, die sortierte Spalte und sortierrichtung für Spalten in einem Spaltensatz aus dem Arbeitsspeicher abzurufen.

Syntax

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

Parameter

[in] pColID

Ein Zeiger auf eine SColumnSetID-Struktur , die die ID des Spaltensatzes enthält, dessen Sortierdaten abgerufen werden sollen.

[out] ppColSortData

Ein Zeiger auf einen Zeiger auf eine MMC_SORT_SET_DATA Struktur, die die Spaltensortierungsdaten des Spaltensatzes enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Wenn der Benutzer ein Bereichselement auswählt und dann die Sortierdaten der Listenansicht des ausgewählten Elements ändert. Wenn das Snap-In IColumnData::GetColumnSortData aufruft, um die gleichen Sortierdaten abzurufen, gibt die Methode die neuen Daten zurück, unabhängig davon, ob der Benutzer das Element deaktiviert hat oder nicht.

Die MMC_SORT_SET_DATA-Struktur und ihr Array von MMC_SORT_DATA-Strukturen werden von MMC während der Aufrufe von GetColumnSortData als ein zusammenhängender Speicherblock zugeordnet. Das Snap-In muss CoTaskMemFree mit dem angegebenen Zeiger auf MMC_SORT_SET_DATA aufrufen. Dadurch wird der gesamte Speicherblock freigegeben.

Alle Datensätze, die von den Methoden der IColumnData-Schnittstelle abgerufen werden, werden von MMC im Arbeitsspeicher und nicht in einem Stream oder Speichermedium beibehalten. Diese Daten werden nur dann in einer MSC-Konsolendatei gespeichert, wenn der Benutzer den Menübefehl Speichern auswählt.

Anforderungen

Weitere Informationen

IColumnData

Verwenden von IColumnData