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 |