Fonction FindClose (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 Server Message Block (SMB) 3.0 Oui
Basculement transparent SMB 3.0 (TFO) Oui
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) Oui
Système de fichiers du volume partagé de cluster (CsvFS) Oui
Système de fichiers résilient (ReFS) Oui
 

Exemples

Pour obtenir un exemple, consultez Liste des fichiers dans un répertoire.

Configuration requise

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

Voir aussi

Fonctions de gestion des fichiers

FindFirstFile

FindFirstFileEx

FindFirstFileNameTransactedW

FindFirstFileNameW

FindFirstFileTransacted

FindFirstStreamTransactedW

FindFirstStreamW

FindNextFile

FindNextFileNameW

FindNextStreamW