FindNextFileNameW-Funktion (fileapi.h)

Setzt das Auflisten der festen Links zu einer Datei mithilfe des Handles fort, das durch einen erfolgreichen Aufruf der FindFirstFileNameW-Funktion zurückgegeben wird.

Syntax

BOOL FindNextFileNameW(
  [in]      HANDLE  hFindStream,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Parameter

[in] hFindStream

Ein Handle für die Enumeration, die von einem erfolgreichen Aufruf von FindFirstFileNameW zurückgegeben wird.

[in, out] StringLength

Die Größe des LinkName-Parameters in Zeichen. Wenn bei diesem Aufruf ein Fehler auftritt und der Fehler ERROR_MORE_DATA ist, ist der von diesem Parameter zurückgegebene Wert die Größe, die LinkName aufweisen 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 ungleich Null.

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

Wenn keine übereinstimmenden Dateien gefunden werden können, gibt die GetLastError-FunktionERROR_HANDLE_EOF zurück.

Hinweise

Wenn die Funktion TRUE zurückgibt, müssen weitere harte Links aufgelistet werden.

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

Anforderungen

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

FindFirstFileNameW