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