IHeaderCtrl2::SetColumnFilter-Methode (mmc.h)

IHeaderCtrl2::SetColumnFilter legt den Filterwert und seine maximale Zeichenlänge für eine angegebene Spalte in einer gefilterten Liste fest.

Syntax

HRESULT SetColumnFilter(
  [in] UINT           nColumn,
  [in] DWORD          dwType,
  [in] MMC_FILTERDATA *pFilterData
);

Parameter

[in] nColumn

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

[in] dwType

Filtertyp, der auf die angegebene Spalte angewendet werden soll, stammt aus der MMC_FILTER_TYPE-Enumeration .

[in] 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 das Snap-In die Filterdaten für eine Spalte in einer gefilterten Liste nicht explizit durch Aufrufen von IHeaderCtrl2::SetColumnFilter festgelegt, wird der Filtertyp standardmäßig auf MMC_STRING_FILTER ohne Standardwert für den Filter (MMC_FILTER_NOVALUE) festgelegt. Die Standardlänge des Filters wird nicht durch das Win32-Headersteuerelement dokumentiert, ist aber von ausreichender Länge für wahrscheinliche Benutzereingaben. Wenn das Snap-In eine bestimmte Länge benötigt, sollte es IHeaderCtrl2::SetColumnFilter aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	mmc.h
DLL	Mmcndmgr.dll

Weitere Informationen

IHeaderCtrl2