Fonction FilterFindNext (fltuser.h)

Article
08/23/2023

La fonction FilterFindNext poursuit une recherche de filtre démarrée par un appel à FilterFindFirst.

Syntaxe

HRESULT FilterFindNext(
  [in]  HANDLE                   hFilterFind,
  [in]  FILTER_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                   lpBuffer,
  [in]  DWORD                    dwBufferSize,
  [out] LPDWORD                  lpBytesReturned
);

Paramètres

[in] hFilterFind

Handle de recherche de filtre retourné par un appel précédent à FilterFindFirst.

[in] dwInformationClass

Type d’informations demandées. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
FilterFullInformation	La mémoire tampon pointée vers par le paramètre lpBuffer reçoit une structure FILTER_FULL_INFORMATION pour chaque minifiltre instance. Les filtres hérités sont ignorés.
FilterAggregateBasicInformation	La mémoire tampon pointée vers par le paramètre lpBuffer reçoit une structure FILTER_AGGREGATE_BASIC_INFORMATION pour chaque minifiltre instance ou filtre hérité. Cette valeur dwInformationClass est disponible à partir de Microsoft Windows Server 2003 avec SP1 et de Windows XP avec SP2 avec le correctif cumulatif du gestionnaire de filtres. Pour plus d’informations sur le package cumulatif du gestionnaire de filtres pour Windows XP avec SP2, consultez l’article 914882, « Le package cumulatif du gestionnaire de filtres pour Windows XP SP2 », dans la Base de connaissances Microsoft.
FilterAggregateStandardInformation	La mémoire tampon pointée vers le paramètre lpBuffer reçoit une structure FILTER_AGGREGATE_STANDARD_INFORMATION pour chaque minifiltre instance ou filtre hérité. Cette valeur dwInformationClass est disponible à partir de Windows Vista.

[out] lpBuffer

Pointeur vers une mémoire tampon allouée à l’appelant qui reçoit les informations demandées. Le type des informations retournées est défini par le paramètre dwInformationClass .

[in] dwBufferSize

Taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre lpBuffer . L’appelant doit définir ce paramètre en fonction de la dwInformationClass donnée.

[out] lpBytesReturned

Pointeur vers une variable allouée à l’appelant qui reçoit le nombre d’octets retournés dans la mémoire tampon vers laquelle lpBuffer pointe si l’appel à FilterFindNext réussit. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

Valeur retournée

FilterFindNext retourne S_OK en cas de réussite. Sinon, il retourne une valeur d’erreur HRESULT, telle que l’une des valeurs suivantes :

Code de retour	Description
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	La mémoire tampon pointée par lpBuffer n’est pas assez grande pour contenir les informations demandées. Lorsque cette valeur est retournée, lpBytesReturned contient la taille, en octets, de la mémoire tampon requise pour la structure dwInformationClass donnée.
HRESULT_FROM_WIN32(ERROR_INVALID_PARAMETER)	Une valeur non valide a été spécifiée pour le paramètre dwInformationClass . Par exemple, si FilterAggregateStandardInformation est spécifié pour un système d’exploitation antérieur à Windows Vista, FilterFindNext retourne cette valeur HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Aucun autre pilote de filtre n’a été trouvé dans la liste globale des pilotes de filtre inscrits.

Remarques

Une fois le handle de recherche de filtre établi en appelant FilterFindFirst, utilisez la fonction FilterFindNext pour rechercher des filtres supplémentaires dans la liste globale des filtres inscrits.

FilterFindNext recherche un pilote de filtre (pilote minifiltre instance ou pilote de filtre hérité) par appel.

À compter de Microsoft Windows Server 2003 avec SP1 et De Microsoft Windows XP avec SP2 avec le correctif cumulatif du gestionnaire de filtres, FilterFindFirst et FilterFindNext peuvent fournir des informations sur le pilote de filtre hérité et des informations sur le pilote de minifiltre instance. Sur les versions antérieures de Windows, FilterFindFirst et FilterFindNext peuvent uniquement fournir des informations sur les minifiltres (voir la description du paramètre dwInformationClass ci-dessus).

FilterFindFirst et FilterFindNext retournent des informations sur les pilotes de filtre dans l’ordre de diminution de la distance par rapport au système de fichiers de base. Les informations sur le filtre le plus éloigné du système de fichiers de base sont retournées en premier. Les informations sur le filtre le plus éloigné sont retournées en deuxième position. Les informations sur le filtre le plus proche du système de fichiers de base sont retournées en dernier.