structure TXFS_GET_TRANSACTED_VERSION (winioctl.h)

Article
03/04/2024

[Microsoft recommande vivement aux développeurs d’utiliser d’autres moyens pour répondre aux besoins de votre application. De nombreux scénarios utilisant TxF peuvent être réalisés à l’aide de techniques plus simples et plus facilement disponibles. En outre, TxF peut ne pas être disponible dans les versions à venir de Microsoft Windows. Pour plus d’informations et les alternatives à TxF, consultez Alternatives à l’utilisation de Transactionnel NTFS.]

Contient les informations sur les versions de base et les dernières versions du fichier spécifié.

Syntaxe

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

Membres

ThisBaseVersion

Version du fichier avec lequel ce handle est ouvert. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
TXFS_TRANSACTED_VERSION_NONTRANSACTED 0xFFFFFFFE	Le fichier n’est pas un fichier traité.
TXFS_TRANSACTED_VERSION_UNCOMMITTED 0xFFFFFFFF	Le fichier a été ouvert en tant qu’enregistreur traité.

Si le handle a été ouvert en tant que lecteur traité, la valeur retournée pour ce membre est un entier positif qui représente le numéro de version du fichier auquel le handle est associé.

LatestVersion

Dernière version validée du fichier.

ThisMiniVersion

Si le handle d’une miniversion est ouvert, ce membre contient l’ID de la miniversion. Si le handle n’est pas ouvert, ce membre est égal à zéro (0).

FirstMiniVersion

Première miniversion disponible pour ce fichier. S’il n’y a pas de miniversions ou si elles ne sont pas visibles par la transaction liée au handle de fichier, ce champ est égal à zéro (0).

LatestMiniVersion

Dernière miniversion disponible pour ce fichier. S’il n’y a pas de miniversions ou si elles ne sont pas visibles par la transaction liée au handle de fichier, ce champ est égal à zéro (0).

Remarques

Le numéro de version de base reste le même pendant la durée de vie d’un handle. Le numéro de version le plus récent augmente tant qu’un handle est toujours ouvert pour un fichier et qu’une modification est validée. Lorsque le handle est fermé, le numéro de version est réinitialisé à zéro.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	winioctl.h (inclure Windows.h)

Voir aussi

FSCTL_TXFS_GET_TRANSACTED_VERSION