structure FILE_ID_GLOBAL_TX_DIR_INFORMATION (ntifs.h)

La structure FILE_ID_GLOBAL_TX_DIR_INFORMATION contient des informations sur la visibilité transactionnelle des fichiers d’un répertoire.

Syntaxe

typedef struct _FILE_ID_GLOBAL_TX_DIR_INFORMATION {
  ULONG         NextEntryOffset;
  ULONG         FileIndex;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER EndOfFile;
  LARGE_INTEGER AllocationSize;
  ULONG         FileAttributes;
  ULONG         FileNameLength;
  LARGE_INTEGER FileId;
  GUID          LockingTransactionId;
  ULONG         TxInfoFlags;
  WCHAR         FileName[1];
} FILE_ID_GLOBAL_TX_DIR_INFORMATION, *PFILE_ID_GLOBAL_TX_DIR_INFORMATION;

Membres

NextEntryOffset

Décalage d’octet à partir du début de cette entrée, auquel se trouve l’entrée FILE_ID_FULL_DIR_INFORMATION suivante si plusieurs entrées sont présentes dans une mémoire tampon. La valeur zéro indique qu’aucune autre entrée ne suit celle-ci.

FileIndex

Décalage d’octet du fichier dans le répertoire parent. Pour les systèmes de fichiers dans lesquels la position d’un fichier dans le répertoire parent n’est pas fixe et peuvent être modifiés pour maintenir l’ordre de tri, ce champ doit être défini sur 0 et est ignoré.

CreationTime

Heure de création du fichier.

LastAccessTime

Dernière fois que le fichier a été accédé.

LastWriteTime

La dernière fois que les informations ont été écrites dans le fichier.

ChangeTime

La dernière fois que le fichier a été modifié.

EndOfFile

Nouvelle position absolue de fin de fichier en tant que décalage d’octets à partir du début du fichier. EndOfFile spécifie le décalage vers l’octet immédiatement après le dernier octet valide dans le fichier.

AllocationSize

Taille d’allocation de fichiers en octets. La valeur de ce champ est un multiple entier de la taille du cluster.

FileAttributes

Attributs de fichier.

Drapeau	Signification
FILE_ATTRIBUTE_NORMAL	Un fichier qui a des attributs standard doit être créé.
FILE_ATTRIBUTE_READONLY	Un fichier en lecture seule doit être créé.
FILE_ATTRIBUTE_HIDDEN	Un fichier masqué doit être créé.
FILE_ATTRIBUTE_SYSTEM	Un fichier système doit être créé.
FILE_ATTRIBUTE_ARCHIVE	Le fichier doit être marqué afin qu’il soit archivé.
FILE_ATTRIBUTE_TEMPORARY	Un fichier temporaire doit être créé.

FileNameLength

Longueur, en octets, du nom de fichier contenu dans le membre FileName.

FileId

Numéro de référence de fichier pour le fichier. Le système de fichiers génère ce numéro et l’affecte au fichier. Pour les systèmes de fichiers qui ne prennent pas en charge FileId, ce champ est défini sur 0 et ignoré.

LockingTransactionId

Valeur GUID de la transaction dont ce fichier est verrouillé pour modification. Le système de fichiers génère et affecte cette valeur.

TxInfoFlags

Or au niveau du bit de zéro ou plus des valeurs suivantes.

Valeur	Signification
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED 0x00000001	Le fichier est verrouillé pour modification par une transaction. L’ID de la transaction doit être contenu dans le membre LockingTransactionId si cet indicateur est défini.
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_TO_TX 0x00000002	Le fichier est visible pour les énumérateurs traités du répertoire dont l’ID de transaction se trouve dans le membre LockingTransactionId.
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_OUTSIDE_TX 0x00000004	Le fichier est visible par les énumérateurs traités du répertoire autre que celui dont l’ID de transaction se trouve dans le LockingTransactionId membre, et il est visible par les énumérateurs non traités du répertoire.

 

Si l’indicateur FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED n’est pas défini, les autres indicateurs ne doivent pas être définis. Si des indicateurs autres que FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED sont définis, l’indicateur FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED doit être défini.

FileName[1]

Séquence de caractères Unicode contenant le nom du fichier.

Remarque Utiliser FileNameLength pour déterminer la longueur du nom de fichier plutôt que de supposer la présence d’un délimiteur Null de fin.

 

Remarques

La structure FILE_ID_GLOBAL_TX_DIR_INFORMATION peut être implémentée pour les systèmes de fichiers qui retournent l’indicateur FILE_SUPPORTS_TRANSACTIONS en réponse à une requête à l’aide d’une structure FILE_FS_ATTRIBUTE_INFORMATION. Il ne doit pas être implémenté pour les systèmes de fichiers qui ne retournent pas cet indicateur.

Si l’indicateur FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED n’est pas défini dans TxInfoFlags, LockingTransactionId est ignoré.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 7
d’en-tête	ntifs.h (include FltKernel.h, Ntifs.h)