IHeaderCtrl2::GetColumnFilter-Methode (mmc.h)

Die IHeaderCtrl2::GetColumnFilter-Methode ruft den Filterwert ab, der für die angegebene Spalte festgelegt ist.

Syntax

HRESULT GetColumnFilter(
  [in]      UINT           nColumn,
  [in, out] LPDWORD        pdwType,
  [in, out] MMC_FILTERDATA *pFilterData
);

Parameter

[in] nColumn

Ein nullbasierter Index, der die Spalte angibt, für die der Filterwert und seine maximale Zeichenlänge abgerufen werden sollen.

[in, out] pdwType

Ein Zeiger auf eine Variable vom Typ DWORD , die einen der möglichen Filterwerte annehmen kann, die in der MMC_FILTER_TYPE-Enumeration angegeben sind. Der Filtertyp für die angegebene Spalte wird in der Adresse platziert, auf die pdwType verweist.

[in, out] pFilterData

Ein Zeiger auf eine MMC_FILTERDATA-Struktur , die die tatsächlichen Filterdaten enthält.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Für das Festlegen und Lesen von Filterwerten besitzt das Snap-In die MMC_FILTERDATA-Struktur und einen beliebigen Textpuffer.

Wenn der vom Snap-In angegebene Filtertyp beim Lesen eines Filterwerts nicht mit dem aktuellen Typ übereinstimmt, gibt die IHeaderCtrl2::GetColumnFilter-MethodeE_FAIL zurück. Beim Empfangen eines E_FAIL sind die von der -Methode zurückgegebenen Werte undefiniert.

Anforderungen

Weitere Informationen

IHeaderCtrl2