TxF-Steuerelementcodes

[Microsoft empfiehlt Entwicklern dringend, alternative Methoden zu verwenden, um die Anforderungen Ihrer Anwendung zu erfüllen. Viele Szenarien, für die TxF entwickelt wurde, können durch einfachere und leichter verfügbare 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 Transaktions-NTFS.]

Transactional NTFS (TxF) stellt die folgenden Steuercodes bereit.

In diesem Abschnitt

Steuerungscode BESCHREIBUNG
FSCTL_TXFS_CREATE_MINIVERSION
Erstellt eine neue Miniversion für die angegebene Datei.
Mit Miniversionen können Sie während einer Transaktion auf eine Momentaufnahme der Datei verweisen. Miniversionen werden verworfen, wenn für eine Transaktion ein Commit ausgeführt oder ein Rollback ausgeführt wird.
FSCTL_TXFS_GET_METADATA_INFO
Ruft Transacted NTFS-Metadaten (TxF) für eine Datei und die GUID der Transaktion ab, die die angegebene Datei gesperrt hat (wenn die Datei gesperrt ist).
FSCTL_TXFS_GET_TRANSACTED_VERSION
Gibt eine TXFS_GET_TRANSACTED_VERSION-Struktur zurück. Die -Struktur identifiziert die zuletzt committete Version der angegebenen Datei, die Versionsnummer des Handles.
FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES
Gibt eine Liste aller Dateien zurück, die derzeit durch die angegebene Transaktion gesperrt sind. Wenn der Rückgabewert ERROR_MORE_DATA ist, wird die Länge des Puffers zurückgegeben, der zum Zeitpunkt dieses Aufrufs für die vollständige Liste der Dateien erforderlich ist.
FSCTL_TXFS_LIST_TRANSACTIONS
Gibt eine Liste aller Transaktionen zurück, die derzeit am angegebenen Ressourcen-Manager beteiligt sind.
FSCTL_TXFS_MODIFY_RM
Legt die Protokollmodus- und Protokollparameterinformationen für einen sekundären Ressourcen-Manager (RM) fest.
FSCTL_TXFS_QUERY_RM_INFORMATION
Ruft Informationen für einen Ressourcen-Manager (RM) ab.
FSCTL_TXFS_READ_BACKUP_INFORMATION
Gibt TxF-spezifische Informationen (Transactional NTFS) für die angegebene Datei zurück.
FSCTL_TXFS_SAVEPOINT_INFORMATION
Die FSCTL_TXFS_SAVEPOINT_INFORMATION Steuerungscodesteuerelemente, die Einstellung, das Löschen und das Rollback zum angegebenen Speicherpunkt.
Um diesen Vorgang auszuführen, rufen Sie die DeviceIoControl-Funktion mit den folgenden Parametern auf.
FSCTL_TXFS_TRANSACTION_ACTIVE
Gibt einen booleschen Wert zurück, der angibt, ob transaktionen auf dem zugeordneten Volume aktiv waren, als die Momentaufnahme genommen wurde. Dieser Aufruf ist nur für schreibgeschützte Momentaufnahme Volumes gültig.
FSCTL_TXFS_WRITE_BACKUP_INFORMATION
Schreibt TxF-spezifische Informationen (Transactional NTFS) in eine angegebene Datei. Der Buffer-Member der TXFS_WRITE_BACKUP_INFORMATION-Struktur muss das Buffer-Element der TXFS_READ_BACKUP_INFORMATION_OUT-Struktur sein, die von FSCTL_TXFS_READ_BACKUP_INFORMATION zurückgegeben wird.