IColumnData::GetColumnConfigData-Methode (mmc.h)

Die IColumnData::GetColumnConfigData-Methode ermöglicht es einem Snap-In, die aktuelle Breite, Reihenfolge und ausgeblendete status jeder Spalte in einem Spaltensatz abzurufen, der von MMC im Arbeitsspeicher gespeichert wird.

Syntax

HRESULT GetColumnConfigData(
  [in]  SColumnSetID        *pColID,
  [out] MMC_COLUMN_SET_DATA **ppColSetData
);

Parameter

[in] pColID

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

[out] ppColSetData

Ein Zeiger auf einen Zeiger auf eine MMC_COLUMN_SET_DATA-Struktur , die die abgerufenen Spaltendaten enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Angenommen, der Benutzer wählt ein Bereichselement aus und ändert dann die Spaltenkonfigurationsdaten der Listenansicht des ausgewählten Elements. Wenn das Snap-In IColumnData::GetColumnConfigData aufruft, um die Spaltenkonfigurationsdaten dieser Listenansicht abzurufen, gibt die Methode die neuen Daten zurück, unabhängig davon, ob der Benutzer das Element deaktiviert hat.

Die MMC_COLUMN_SET_DATA-Struktur und ihr Array von MMC_COLUMN_DATA-Strukturen werden von MMC während aufrufen von GetColumnConfigData als ein zusammenhängender Speicherblock zugeordnet. Das Snap-In muss CoTaskMemFree mit dem angegebenen Zeiger auf MMC_COLUMN_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 in einem gespeichert. Msc-Konsolendatei nur, wenn der Benutzer auf den Menübefehl Speichern klickt.

Anforderungen

Weitere Informationen

IColumnData

Verwenden von IColumnData