Fonction FindNextVolumeMountPointA (winbase.h)

  • Article

Poursuit une recherche de dossiers montés démarrée par un appel à la fonction FindFirstVolumeMountPoint. FindNextVolumeMountPoint recherche un dossier monté par appel.

Syntaxe

BOOL FindNextVolumeMountPointA(
  [in]  HANDLE hFindVolumeMountPoint,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

Paramètres

[in] hFindVolumeMountPoint

Un handle de recherche de dossier monté retourné par un appel précédent à la fonction FindFirstVolumeMountPoint .

[out] lpszVolumeMountPoint

Pointeur vers une mémoire tampon qui reçoit le nom du dossier monté trouvé.

[in] cchBufferLength

Longueur de la mémoire tampon qui reçoit le nom du dossier monté, dans les TCHAR.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Si aucun autre dossier monté n’est trouvé, la fonction GetLastError retourne le code d’erreur ERROR_NO_MORE_FILES. Dans ce cas, fermez la recherche avec la fonction FindVolumeMountPointClose .

Remarques

Une fois le handle de recherche établi en appelant FindFirstVolumeMountPoint, vous pouvez utiliser la fonction FindNextVolumeMountPoint pour rechercher d’autres dossiers montés.

Les fonctions FindFirstVolumeMountPoint, FindNextVolumeMountPoint et FindVolumeMountPointClose retournent les chemins d’accès aux dossiers montés pour un volume spécifié. Ils ne retournent pas de lettres de lecteur ou de chemins GUID de volume. Pour plus d’informations sur l’énumération des chemins GUID de volume pour un volume, consultez Énumération des chemins d’accès GUID de volume.

Vous ne devez pas supposer une corrélation entre l’ordre des dossiers montés retournés avec ces fonctions et l’ordre des dossiers montés retournés par d’autres fonctions ou outils.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie Prise en charge
Protocole Server Message Block (SMB) 3.0 No
Basculement transparent SMB 3.0 (TFO) No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) No
Système de fichiers du volume partagé de cluster (CsvFS) No
Système de fichiers résilient (ReFS) No
 

SMB ne prend pas en charge les fonctions de gestion des volumes. CsvFS ne prend pas en charge l’ajout d’un point de montage sur un volume CSV. ReFS n’indexe pas les points de montage.

Notes

L’en-tête winbase.h définit FindNextVolumeMountPoint comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

FindFirstVolumeMountPoint

FindVolumeMountPointClose

Dossiers montés

Fonctions de gestion des volumes