FindFirstFileNameW-Funktion (fileapi.h)
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.
[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 |