Méthode IHeaderCtrl2 ::GetColumnFilter (mmc.h)
La méthode IHeaderCtrl2 ::GetColumnFilter récupère la valeur de filtre définie sur la colonne spécifiée.
Syntaxe
HRESULT GetColumnFilter(
[in] UINT nColumn,
[in, out] LPDWORD pdwType,
[in, out] MMC_FILTERDATA *pFilterData
);
Paramètres
[in] nColumn
Index de base zéro qui identifie la colonne pour laquelle la valeur de filtre et sa longueur maximale de caractères doivent être récupérées.
[in, out] pdwType
Pointeur vers une variable de type DWORD qui peut prendre l’une des valeurs de filtre possibles spécifiées dans l’énumération MMC_FILTER_TYPE . Le type de filtre de la colonne spécifiée est placé dans l’adresse pointée par pdwType.
[in, out] pFilterData
Pointeur vers une structure de MMC_FILTERDATA qui contient les données de filtre réelles.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Remarques
Pour la définition et la lecture des valeurs de filtre, le composant logiciel enfichable possède la structure MMC_FILTERDATA et la mémoire tampon de texte.
Lors de la lecture d’une valeur de filtre, si le type de filtre spécifié par le composant logiciel enfichable ne correspond pas au type actuel, la méthode IHeaderCtrl2 ::GetColumnFilter retourne E_FAIL. À la réception d’un E_FAIL, les valeurs retournées par la méthode ne sont pas définies.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | mmc.h |
| DLL | Mmcndmgr.dll |