Fonction FilterVolumeFindNext (fltuser.h)

Article
08/23/2023

La fonction FilterVolumeFindNext poursuit une recherche en volume démarrée par un appel à FilterVolumeFindFirst.

Syntaxe

HRESULT FilterVolumeFindNext(
  [in]  HANDLE                          hVolumeFind,
  [in]  FILTER_VOLUME_INFORMATION_CLASS dwInformationClass,
  [out] LPVOID                          lpBuffer,
  [in]  DWORD                           dwBufferSize,
  [out] LPDWORD                         lpBytesReturned
);

Paramètres

[in] hVolumeFind

Handle de recherche en volume retourné par un appel précédent à FilterVolumeFindFirst.

[in] dwInformationClass

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

Valeur	Signification
FilterVolumeBasicInformation	La mémoire tampon pointée vers par le paramètre lpBuffer reçoit une structure FILTER_VOLUME_BASIC_INFORMATION pour le volume.
FilterVolumeStandardInformation	La mémoire tampon pointée vers le paramètre lpBuffer reçoit une structure FILTER_VOLUME_STANDARD_INFORMATION pour le volume. 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 par l’appelant qui reçoit le nombre d’octets retournés dans la mémoire tampon vers laquelle lpBuffer pointe si l’appel à FilterVolumeFindNext réussit. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

Valeur retournée

FilterVolumeFindNext retourne S_OK s’il retourne correctement les informations de volume. 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 FilterVolumeStandardInformation est spécifié pour un système d’exploitation antérieur à Windows Vista, FilterVolumeFindNext retourne cette valeur HRESULT.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)	Aucun autre volume n’a été trouvé dans la liste des volumes connus du gestionnaire de filtres.

Notes

Une fois le handle de recherche établi en appelant FilterVolumeFindFirst, utilisez la fonction FilterVolumeFindNext pour rechercher d’autres volumes. FilterVolumeFindNext recherche un volume par appel.

Notez que lorsque vous utilisez FilterVolumeFindFirst et FilterVolumeFindNext pour énumérer la liste des volumes connus du gestionnaire de filtres, il est possible que deux volumes de la liste aient le même nom. Pour plus d’informations, consultez Présentation des énumérations de volumes avec des noms de volumes en double.