Anmerkung
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen, dich anzumelden oder die Verzeichnisse zu wechseln.
Der Zugriff auf diese Seite erfordert eine Genehmigung. Du kannst versuchen , die Verzeichnisse zu wechseln.
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 |