TXFS_GET_TRANSACTED_VERSION-Struktur (winioctl.h)

Artikel
03/04/2024

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

Enthält die Informationen über die Basisversion und die neuesten Versionen der angegebenen Datei.

Syntax

typedef struct _TXFS_GET_TRANSACTED_VERSION {
  DWORD ThisBaseVersion;
  DWORD LatestVersion;
  WORD  ThisMiniVersion;
  WORD  FirstMiniVersion;
  WORD  LatestMiniVersion;
} TXFS_GET_TRANSACTED_VERSION, *PTXFS_GET_TRANSACTED_VERSION;

Member

ThisBaseVersion

Die Version der Datei, mit der dieses Handle geöffnet wird. Dieser Member kann einer der folgenden Werte sein.

Wert	Bedeutung
TXFS_TRANSACTED_VERSION_NONTRANSACTED 0xFFFFFFFE	Die Datei ist keine transaktionsfähige Datei.
TXFS_TRANSACTED_VERSION_UNCOMMITTED 0xFFFFFFFF	Die Datei wurde als Transacted Writer geöffnet.

Wenn das Handle als Transaktionsleser geöffnet wurde, ist der für dieses Element zurückgegebene Wert eine positive ganze Zahl, die die Versionsnummer der Datei darstellt, der das Handle zugeordnet ist.

LatestVersion

Die zuletzt zugesagte Version der Datei.

ThisMiniVersion

Wenn das Handle zu einer Miniversion geöffnet ist, enthält dieses Element die ID der Miniversion. Wenn das Handle nicht geöffnet ist, ist dieser Member null (0).

FirstMiniVersion

Die erste verfügbare Miniversion für diese Datei. Wenn keine Miniversionen vorhanden sind oder sie für die Transaktion, die an das Dateihandle gebunden ist, nicht sichtbar sind, ist dieses Feld 0 (0).

LatestMiniVersion

Die neueste verfügbare Miniversion für diese Datei. Wenn keine Miniversionen vorhanden sind oder sie für die Transaktion, die an das Dateihandle gebunden ist, nicht sichtbar sind, ist dieses Feld 0 (0).

Hinweise

Die Basisversionsnummer bleibt für die Lebensdauer eines Handles gleich. Die neueste Versionsnummer wird erhöht, solange ein Handle noch für eine Datei geöffnet ist und eine Änderung committet wird. Wenn das Handle geschlossen ist, wird die Versionsnummer auf 0 zurückgesetzt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	winioctl.h (einschließlich Windows.h)

Weitere Informationen

FSCTL_TXFS_GET_TRANSACTED_VERSION

Freigeben über