Partager via


Fonction FindVolumeClose (fileapi.h)

Ferme le handle de recherche de volume spécifié. Les fonctions FindFirstVolume et FindNextVolume utilisent ce handle de recherche pour localiser les volumes.

Syntaxe

BOOL FindVolumeClose(
  [in] HANDLE hFindVolume
);

Paramètres

[in] hFindVolume

Handle de recherche de volume à fermer. Ce handle doit avoir été précédemment ouvert par la fonction FindFirstVolume .

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.

Remarques

Une fois la fonction FindVolumeClose appelée, le handle hFindVolume ne peut pas être utilisé dans les appels suivants à FindNextVolume ou FindVolumeClose.

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) Oui
Système de fichiers résilient (ReFS) Oui
 

SMB ne prend pas en charge les fonctions de gestion des volumes.

Exemples

Pour obtenir un exemple, consultez Affichage des chemins d’accès aux volumes.

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 fileapi.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

FindFirstVolume

FindNextVolume

Dossiers montés

Fonctions de gestion des volumes