FindClose-Funktion (fileapi.h)

Artikel
02/28/2024

Schließt ein Dateisuchhandle, das von den Funktionen FindFirstFile,FindFirstFileEx, FindFirstFileNameW, FindFirstFileNameTransactedW, FindFirstFileTransacted, FindFirstStreamTransactedW oder FindFirstStreamW geöffnet wird.

Syntax

BOOL FindClose(
  [in, out] HANDLE hFindFile
);

Parameter

[in, out] hFindFile

Das Dateisuchhandle.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Nachdem die FindClose-Funktion aufgerufen wurde, kann das vom hFindFile-Parameter angegebene Handle nicht in nachfolgenden Aufrufen der Funktionen FindNextFile, FindNextFileNameW, FindNextStreamW oder FindClose verwendet werden.

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

Beispiele

Ein Beispiel finden Sie unter Auflisten der Dateien in einem Verzeichnis.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	fileapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll