Die Community zu .NET und Classic VB.
Menü

FindFirstFile

 von 

Deklaration  

Declare Function FindFirstFile Lib "kernel32" _
                 Alias "FindFirstFileA" ( _
                 ByVal lpFileName As String, _
                 lpFindFileData As WIN32_FIND_DATA) As Long
Weitere 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
lpFileNameEin 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.
lpFindFileDataEin 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_ARCHIVEEs handelt sich um eine Archivdatei
FILE_ATTRIBUTE_DIRECTORYEs handelt sich um ein Verzeichnis
FILE_ATTRIBUTE_HIDDENEs handelt sich um eine versteckte Datei
FILE_ATTRIBUTE_NORMALDie Datei hat keine anderen Attribute, Dieser Wert hat nur Gültigkeit, wenn er alleine verwendet wird
FILE_ATTRIBUTE_READONLYEs besteht nur Lesezugriff
FILE_ATTRIBUTE_SYSTEMDie Datei ist Teil des Betriebssystems oder wird von ihm verwendet
FILE_ATTRIBUTE_TEMPORARYDie Datei wird als temporäre Datei verwendet
FILE_ATTRIBUTE_ATOMIC_WRITEReserviert, nicht verwendet
FILE_ATTRIBUTE_XACTION_WRITEReserviert, nicht verwendet

Tabelle 2


Rückgabewerte
HandleWurde 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_VALUEEs 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