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 |