FindFirstFileExFromAppW-Funktion (fileapifromapp.h)

Durchsucht ein Verzeichnis nach einer Datei oder einem Unterverzeichnis mit einem Namen und Attributen, die den angegebenen Attributen entsprechen. Das Verhalten dieser Funktion ist mit FindFirstFileEx identisch, mit dem Unterschied, dass diese Funktion dem Universelle Windows-Plattform App-Sicherheitsmodells entspricht.

Syntax

WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
  LPCWSTR            lpFileName,
  FINDEX_INFO_LEVELS fInfoLevelId,
  LPVOID             lpFindFileData,
  FINDEX_SEARCH_OPS  fSearchOp,
  LPVOID             lpSearchFilter,
  DWORD              dwAdditionalFlags
) noexcept;

Parameter

lpFileName

Das Verzeichnis oder den Pfad und der Dateiname. Der Dateiname kann Platzhalterzeichen enthalten, z. B. ein Sternchen (*) oder ein Fragezeichen (?).

Dieser Parameter darf nicht NULL sein, keine ungültige Zeichenfolge (z. B. eine leere Zeichenfolge oder eine Zeichenfolge, der das beendende NULL-Zeichen fehlt) oder in einem nachfolgenden umgekehrten Schrägstrich (\) enden.

Wenn die Zeichenfolge mit einem Feldhalter, Punkt oder Verzeichnisnamen endet, muss der Benutzer Zugriff auf den Stamm und alle Unterverzeichnisse im Pfad haben.

Weitere Informationen zum Deaktivieren der MAX_PATH Einschränkung ohne Vorheriges "\\?\" finden Sie im Abschnitt "Maximale Pfadlängenbegrenzung" unter Benennungsdateien, Pfade und Namespaces .

fInfoLevelId

Die Informationsebene der zurückgegebenen Daten.

Dieser Parameter ist einer der FINDEX_INFO_LEVELS Enumerationswerte.

lpFindFileData

Ein Zeiger auf den Puffer, der die Dateidaten empfängt.

Der Zeigertyp wird durch die Informationsebene bestimmt, die im fInfoLevelId-Parameter angegeben ist.

fSearchOp

Der Typ der auszuführenden Filterung, die sich von der Abgleichung des Feldhalters unterscheidet.

Dieser Parameter ist einer der FINDEX_SEARCH_OPS Enumerationswerte.

lpSearchFilter

Ein Zeiger auf die Suchkriterien, wenn der angegebene fSearchOp strukturierte Suchinformationen benötigt.

Derzeit erfordert keiner der unterstützten fSearchOp-Werte erweiterte Suchinformationen. Daher muss dieser Zeiger NULL sein.

dwAdditionalFlags

Gibt zusätzliche Flags an, die die Suche steuern.

Wert	Bedeutung
FIND_FIRST_EX_CASE_SENSITIVE 1	Bei Suchvorgängen wird die Groß-/Kleinschreibung beachtet.
FIND_FIRST_EX_LARGE_FETCH 2	Verwendet einen größeren Puffer für Verzeichnisabfragen, der die Leistung des Suchvorgangs erhöhen kann.
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4	Schränkt die Ergebnisse auf Dateien ein, die sich physisch auf dem Datenträger befinden. Dieses Flag ist nur relevant, wenn ein Dateivirtualisierungsfilter vorhanden ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das in einem nachfolgenden Aufruf von FindNextFile oder FindClose verwendet wird, und der lpFindFileData-Parameter enthält Informationen über die erste Gefundene Datei oder das erste gefundene Verzeichnis.

Wenn die Funktion dateien aus der Suchzeichenfolge im lpFileName-Parameter nicht finden kann, ist der Rückgabewert INVALID_HANDLE_VALUE , und der Inhalt von lpFindFileData ist unbestimmt. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	fileapifromapp.h