FindFirstFileNameW-Funktion (fileapi.h)

Artikel
08/23/2023

Erstellt eine Enumeration aller festen Links zur angegebenen Datei. Die FindFirstFileNameW-Funktion gibt ein Handle für die Enumeration zurück, das bei nachfolgenden Aufrufen der FindNextFileNameW-Funktion verwendet werden kann.

Um diesen Vorgang als transaktionierten Vorgang auszuführen, verwenden Sie die FindFirstFileNameTransactedW-Funktion .

Syntax

HANDLE FindFirstFileNameW(
  [in]      LPCWSTR lpFileName,
  [in]      DWORD   dwFlags,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Parameter

[in] lpFileName

Der Name der Datei.

Tipp Ab Windows 10, Version 1607, können Sie die MAX_PATH-Einschränkung entfernen, ohne "\\?\" vorauszustellen. Weitere Informationen finden Sie im Abschnitt "Maximale Pfadlängenbegrenzung" unter Benennung von Dateien, Pfaden und Namespaces .

[in] dwFlags

Reserviert; Geben Sie null (0) an.

[in, out] StringLength

Die Größe des Puffers, auf den der LinkName-Parameter in Zeichen verweist. Wenn bei diesem Aufruf ein Fehler auftritt und der von der GetLastError-Funktion zurückgegebene Fehler ERROR_MORE_DATA (234) ist, ist der von diesem Parameter zurückgegebene Wert die Größe, auf die der Puffer, auf den linkName verweist, sein muss, um alle Daten zu enthalten.

[in, out] LinkName

Ein Zeiger auf einen Puffer zum Speichern des ersten Linknamens, der für lpFileName gefunden wurde.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das mit der FindNextFileNameW-Funktion verwendet oder mit der FindClose-Funktion geschlossen werden kann.

Wenn die Funktion fehlschlägt, wird der Rückgabewert INVALID_HANDLE_VALUE (0xffffffff). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

Hinweise

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)	No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	No
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	fileapi.h (einschließlich Windows.h, WinBase.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Dateiverwaltungsfunktionen

FindClose

FindFirstFileNameTransactedW

FindNextFileNameW

Freigeben über