FindFirstFile
von ActiveVB-Team
Deklaration
Declare Function FindFirstFile Lib "kernel32" _ Alias "FindFirstFileA" ( _ ByVal lpFileName As String, _ lpFindFileData As WIN32_FIND_DATA) As LongWeitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel FindFirstFile des API-Wikis.
FindFirstFile durchsuch ein Verzeichnis nach der ersten Datei, deren Namen mit der angegebenen Suchmaske übereinstimmt. FindFirstFile betrachtet auch Unterverzeichnisse als Dateinamen. Eine Anwendung kann dann wiederholt die Funktion FindNextFile aufrufen, um alle Dateien und Verzeichnisse zu ermitteln, die mit der Suchmaske übereinstimmen.
Parameter | |
---|---|
lpFileName | Ein Zeiger auf einen nullterminierten String, der ein gültiges Verzeichnis oder Pfad und einen Dateinamen, der Wildcards (* und ?) enthalten darf, angibt. Dieser String darf nicht länger als MAX_PATH sein. Eine Anwendung unter Windows NT kann diese Grenze überschreiten, indem sie die W-Version (Wide) von FindFirstFile verwendet und mit \\?\ oder \\?\UNC\ das Pfad Parsing ausschaltet. |
lpFindFileData | Ein Zeiger auf eine WIN32_FIND_DATA Struktur, die nach dem Aufruf die Informationen über die gefundene Datei oder das Unterverzeichnis enthält. Diese Struktur kann in den folgenden Aufrufen durch FindNextFile verwendet werden, um auf die gefundenen Dateien oder Verzeichnisse zu verweisen. |
Tabelle 1
dwFile Attribute, WIN32_FIND_DATA | |
---|---|
FILE_ATTRIBUTE_ARCHIVE | Es handelt sich um eine Archivdatei |
FILE_ATTRIBUTE_DIRECTORY | Es handelt sich um ein Verzeichnis |
FILE_ATTRIBUTE_HIDDEN | Es handelt sich um eine versteckte Datei |
FILE_ATTRIBUTE_NORMAL | Die Datei hat keine anderen Attribute, Dieser Wert hat nur Gültigkeit, wenn er alleine verwendet wird |
FILE_ATTRIBUTE_READONLY | Es besteht nur Lesezugriff |
FILE_ATTRIBUTE_SYSTEM | Die Datei ist Teil des Betriebssystems oder wird von ihm verwendet |
FILE_ATTRIBUTE_TEMPORARY | Die Datei wird als temporäre Datei verwendet |
FILE_ATTRIBUTE_ATOMIC_WRITE | Reserviert, nicht verwendet |
FILE_ATTRIBUTE_XACTION_WRITE | Reserviert, nicht verwendet |
Tabelle 2
Rückgabewerte | |
---|---|
Handle | Wurde die funktion erfolgreich ausgeführt, wird das Suchhandle zurückgegeben, das für die folgenden Aufrufe der Funktionen FindNextFile und FindClose Verwendung findet. |
INVALID_HANDLE_VALUE | Es lag ein Fehler vor. |
Tabelle 3
Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT
Verwandte API-Funktionen
FindClose, FindNextFile, GetFileAttributes, SetFileAttributes
Zugehörige Tipps