_findclose
Nach oben zu io.h - Index
Header-Datei
io.h
Kategorie
Verzeichnisbearbeitungsroutinen
Prototyp
int _findclose(long handle);
Beschreibung
Schließt das angegebene Such-Handle und gibt die Ressourcen frei, die mit vorherigen Aufrufen von findfirst/findnext verbunden sind. Bei dem Parameter handle handelt es sich um das Such-Handle, das vom vorherigen Aufruf von _findfirst zurückgegeben wurde.
Diese Funktion wird aus Gründen der Kompatibilität mit Microsoft bereitgestellt.
Rückgabewert
Bei erfolgreicher Ausführung gibt die Funktion 0 zurück.
Andernfalls wird –1 zurückgegeben und errno einer der folgenden Werte zugewiesen:
ENOENT File specification that could not be matched (Datei oder Verzeichnis nicht gefunden)
Beispiel
#include <io.h> void print_dir(wchar_t* dir_name) { /* Open a find stream (_wfinddata_t and a find handle) */ _wfinddata_t find_data; long handle = __wfindfirst(dir_name, &find_data); /* Check for errors */ if (!handle) return; /* Scan all files that match */ do { printf("%ls\n", find_data.name); } while (!__wfindnext(handle, &find_data)); /* Close the find handle */ _findclose(handle); }
Portabilität
POSIX | Win32 | ANSI C | ANSI C++ | |
---|---|---|---|---|
_findclose |
+ |