FindClose, fonction (fileapi.h)
Ferme un handle de recherche de fichiers ouvert par les fonctions FindFirstFile, FindFirstFileEx, FindFirstFileNameW, FindFirstFileNameTransactedW, FindFirstFileTransacted, FindFirstStreamTransactedW ou FindFirstStreamW.
Syntaxe
BOOL FindClose(
[in, out] HANDLE hFindFile
);
Paramètres
[in, out] hFindFile
Handle de recherche de fichiers.
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 FindClose appelée, le handle spécifié par le paramètre hFindFile ne peut pas être utilisé dans les appels suivants aux fonctions FindNextFile, FindNextFileNameW, FindNextStreamW ou FindClose.
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Prise en charge |
|---|---|
| Protocole SMB (Server Message Block) 3.0 | Yes |
| Basculement transparent SMB 3.0 (TFO) | Yes |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | Yes |
| Cluster Shared Volume File System (CsvFS) | Yes |
| Système de fichiers résilient (ReFS) | Oui |
Exemples
Pour obtenir un exemple, consultez Lister les fichiers dans un répertoire.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | fileapi.h (include Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |