Freigeben über

TxF-Steuercodes

  • Artikel

[Microsoft empfiehlt Entwicklern dringend, alternative Mittel zu nutzen, um Ihre Anwendungsanforderungen zu erreichen. 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 Transactional NTFS.]

Transactional NTFS (TxF) stellt die folgenden Steuercodes bereit.

In diesem Abschnitt

Steuerelementcode Beschreibung
FSCTL_TXFS_CREATE_MINIVERSION
 Erstellt eine neue Miniversions- für die angegebene Datei.
Miniversionen ermöglichen es Ihnen, während einer Transaktion auf eine Momentaufnahme der Datei zu verweisen. Miniversionen werden verworfen, wenn eine Transaktion zugesichert oder zurückgesetzt 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 zugesicherte 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_DATAist, gibt er die Länge des Puffers zurück, der zum Speichern der vollständigen Liste der Dateien zum Zeitpunkt dieses Aufrufs 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 transaktionsspezifische NTFS-Informationen (TxF) für die angegebene Datei zurück.
FSCTL_TXFS_SAVEPOINT_INFORMATION
 Die FSCTL_TXFS_SAVEPOINT_INFORMATION Steuerelementcode steuert die Einstellung, das Löschen und das Zurücksetzen auf den angegebenen Speicherpunkt.
Rufen Sie zum Ausführen dieses Vorgangs die DeviceIoControl--Funktion mit den folgenden Parametern auf.
FSCTL_TXFS_TRANSACTION_ACTIVE
 Gibt einen booleschen Wert, der angibt, ob Transaktionen auf dem zugeordneten Volume aktiv waren, als die Momentaufnahme erstellt wurde. Dieser Aufruf ist nur für schreibgeschützte Momentaufnahmenvolumes gültig.
FSCTL_TXFS_WRITE_BACKUP_INFORMATION
 Schreibt transaktionsspezifische NTFS-Informationen (TxF) in eine angegebene Datei. Das Buffer Member der TXFS_WRITE_BACKUP_INFORMATION-Struktur muss das Buffer Member der TXFS_READ_BACKUP_INFORMATION_OUT Struktur sein, die von FSCTL_TXFS_READ_BACKUP_INFORMATIONzurückgegeben wird.