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

Siehe auch

Dateiverwaltungsfunktionen

FindClose

FindNextFileNameW

Transaktions-NTFS