FindFirstStreamW-Funktion (fileapi.h)

Artikel
08/23/2023

Zählt den ersten Stream mit dem Streamtyp ::$DATA in der angegebenen Datei oder im angegebenen Verzeichnis auf.

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

Syntax

HANDLE FindFirstStreamW(
  [in]  LPCWSTR            lpFileName,
  [in]  STREAM_INFO_LEVELS InfoLevel,
  [out] LPVOID             lpFindStreamData,
        DWORD              dwFlags
);

Parameter

[in] lpFileName

Der vollqualifizierte Dateiname.

[in] InfoLevel

Die Informationsebene der zurückgegebenen Daten. Dieser Parameter ist einer der Werte im STREAM_INFO_LEVELS Enumerationstyp.

Wert	Bedeutung
FindStreamInfoStandard 0	Die Daten werden in einer WIN32_FIND_STREAM_DATA-Struktur zurückgegeben.

[out] lpFindStreamData

Ein Zeiger auf einen Puffer, der die Dateistreamdaten empfängt. Das Format dieser Daten hängt vom Wert des InfoLevel-Parameters ab.

dwFlags

Für die zukünftige Verwendung reserviert. Dieser Parameter muss null sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Suchhandle, das in nachfolgenden Aufrufen der FindNextStreamW-Funktion verwendet werden kann.

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

Wenn keine Streams gefunden werden können, schlägt die Funktion fehl, und GetLastError gibt ERROR_HANDLE_EOF (38) zurück.

Wenn das Dateisystem keine Streams unterstützt, schlägt die Funktion fehl, und GetLastError gibt ERROR_INVALID_PARAMETER (87) zurück.

Hinweise

Die FindFirstStreamW-Funktion öffnet ein Suchhandle und gibt Informationen zum ersten $DATA Stream in der angegebenen Datei oder dem angegebenen Verzeichnis zurück. Bei Dateien ist dies immer der standardmäßige Datenstrom ohne Namen , "::$DATA". Verzeichnisse verfügen standardmäßig nicht über $DATA Streams und können keinen unbenannten Datenstrom haben, aber möglicherweise benannte Datenströme, die nach der Erstellung festgelegt wurden. Nachdem das Suchhandle eingerichtet wurde, verwenden Sie es in Aufrufen der FindNextStreamW-Funktion , um nach anderen Streams in der angegebenen Datei oder dem angegebenen Verzeichnis zu suchen. Wenn das Suchhandle nicht mehr benötigt wird, sollte es mit der FindClose-Funktion geschlossen 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)	Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

SMB 3.0 unterstützt eine Liste von Streams, die kleiner oder gleich 64K sind.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	fileapi.h (include Windows.h, WinBase.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll