FilterInstanceFindNext, fonction (fltuser.h)

Article
08/23/2023

La fonction FilterInstanceFindNext poursuit un pilote minifilter instance recherche démarrée par un appel à FilterInstanceFindFirst.

Syntaxe

HRESULT FilterInstanceFindNext(
  [in]  HANDLE                     hFilterInstanceFind,
  [in]  INSTANCE_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                     lpBuffer,
  [in]  DWORD                      dwBufferSize,
  [out] LPDWORD                    lpBytesReturned
);

Paramètres

[in] hFilterInstanceFind

Minifilter instance handle de recherche retourné par un appel précédent à FilterInstanceFindFirst.

[in] dwInformationClass

Type de structure d’informations instance retournée. Ce paramètre doit contenir l’une des valeurs suivantes.

Valeur	Signification
InstanceBasicInformation	Retourne une structure INSTANCE_BASIC_INFORMATION pour le instance.
InstanceFullInformation	Retourne une structure INSTANCE_FULL_INFORMATION pour le instance.
InstancePartialInformation	Retourne une structure INSTANCE_PARTIAL_INFORMATION pour le instance.
InstanceAggregateStandardInformation	Retourne une structure INSTANCE_AGGREGATE_STANDARD_INFORMATION pour le instance. La partie LegacyFilter de la structure n’est pas utilisée. Cette structure 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 dans la mémoire tampon 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 à FilterInstanceFindNext réussit. Ce paramètre est obligatoire et ne peut pas être NULL.

Valeur retournée

FilterInstanceFindNext retourne S_OK en cas de réussite. Sinon, elle retourne une valeur d’erreur HRESULT, telle que l’une des 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 InstanceAggregateStandardInformation est spécifié pour un système d’exploitation antérieur à Windows Vista, FilterInstanceFindNext renvoie cette valeur HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Cette valeur HRESULT est retournée s’il n’existe plus d’instances uniques du minifiltre.

Notes

Une fois le handle de recherche établi en appelant FilterInstanceFindFirst, appelez FilterInstanceFindNext pour rechercher d’autres instances pour le minifiltre spécifié dans l’appel à FilterInstanceFindFirst.

FilterInstanceFindNext recherche un instance par appel.