FindFirstStreamTransactedW-Funktion (winbase.h)

Artikel
08/27/2023

[Microsoft empfiehlt Entwicklern dringend, alternative Mittel zu verwenden, um die Anforderungen Ihrer Anwendung zu erfüllen. Viele Szenarios, für die TxF entwickelt wurde, können mit einfacheren und leichter verfügbaren Techniken erreicht werden. Darüber hinaus ist TxF in zukünftigen Versionen von Microsoft Windows möglicherweise nicht verfügbar. Weitere Informationen und Alternativen zu TxF finden Sie unter Alternativen zur Verwendung von transaktionalem NTFS.]

Listet den ersten Stream in der angegebenen Datei oder dem angegebenen Verzeichnis als Transaktionsvorgang auf.

Syntax

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

Parameter

[in] lpFileName

Der vollqualifizierte Dateiname.

Die Datei muss sich auf dem lokalen Computer befinden. Andernfalls schlägt die Funktion fehl, und der letzte Fehlercode ist auf ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805) festgelegt.

[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 Dateidaten 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.

[in] hTransaction

Ein Handle für die Transaktion. Dieses Handle wird von der CreateTransaction-Funktion zurückgegeben.

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.

Hinweise

Alle Dateien enthalten einen Standarddatenstrom. Unter NTFS können Dateien auch einen oder mehrere benannte Datenströme enthalten. Auf FAT-Dateisystemen können Dateien nicht mehr als der Standarddatenstrom aufweisen, daher gibt diese Funktion keine gültigen Ergebnisse zurück, wenn sie für FAT-Dateisystemdateien verwendet wird. Diese Funktion funktioniert auf allen Dateisystemen, die feste Links unterstützen. Andernfalls gibt die Funktion ERROR_STATUS_NOT_IMPLEMENTED (6805) zurück.

Die FindFirstStreamTransactedW-Funktion öffnet ein Suchhandle und gibt Informationen zum ersten Stream in der angegebenen Datei oder dem angegebenen Verzeichnis zurück. Bei Dateien ist dies immer der Standarddatenstrom ::$DATA. Nachdem das Suchhandle eingerichtet wurde, verwenden Sie es in der FindNextStreamW-Funktion , um in der angegebenen Datei oder dem angegebenen Verzeichnis nach anderen Datenströmen 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)	No
SMB 3.0 Transparent Failover (TFO)	No
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	No
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	No
Robustes Dateisystem (Resilient File System, ReFS)	No

SMB 3.0 unterstützt TxF nicht.

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	winbase.h (Windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll