FindFirstFileNameTransactedW-Funktion (winbase.h)
[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.]
Erstellt eine Enumeration aller festen Links zur angegebenen Datei als Transaktionsvorgang. Die Funktion gibt ein Handle für die Enumeration zurück, das bei nachfolgenden Aufrufen der FindNextFileNameW-Funktion verwendet werden kann.
Syntax
HANDLE FindFirstFileNameTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName,
[in, optional] HANDLE hTransaction
);
Parameter
[in] lpFileName
Der Name der Datei.
Die Datei muss sich auf dem lokalen Computer befinden. Andernfalls schlägt die Funktion fehl, und der letzte Fehlercode wird auf ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805) festgelegt.
[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 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.
[in, optional] 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 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). Beschreibung
rufen Sie erweiterte Fehlerinformationen ab, und 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) | 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
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winbase.h (einschließlich Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |