structure FILE_ID_EXTD_DIR_INFO (winbase.h)

Contient les informations d’identification d’un fichier. Cette structure est retournée par la fonction GetFileInformationByHandleEx lorsque FileIdExtdDirectoryInfo (0x13) ou FileIdExtdDirectoryRestartInfo (0x14) est passé dans le paramètre FileInformationClass .

Syntaxe

typedef struct _FILE_ID_EXTD_DIR_INFO {
  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;
  ULONG         EaSize;
  ULONG         ReparsePointTag;
  FILE_ID_128   FileId;
  WCHAR         FileName[1];
} FILE_ID_EXTD_DIR_INFO, *PFILE_ID_EXTD_DIR_INFO;

Membres

NextEntryOffset

Décalage de la structure FILE_ID_EXTD_DIR_INFO suivante retournée. Contient zéro (0) si aucune autre entrée ne suit celle-ci.

FileIndex

Décalage d’octet du fichier dans le répertoire parent. Ce membre n’est pas défini pour les systèmes de fichiers, tels que NTFS, dans lesquels la position d’un fichier dans le répertoire parent n’est pas fixe et peut être modifiée à tout moment pour maintenir l’ordre de tri.

CreationTime

Heure de création du fichier.

LastAccessTime

Heure à laquelle le fichier a été consulté pour la dernière fois.

LastWriteTime

Heure à laquelle le fichier a été écrit pour la dernière fois.

ChangeTime

Heure de la dernière modification du fichier.

EndOfFile

Nouvelle position absolue de fin de fichier en tant que décalage d’octet entre le début du fichier et la fin du fichier. Étant donné que cette valeur est de base zéro, elle fait en fait référence au premier octet libre dans le fichier. En d’autres termes, EndOfFile est le décalage vers l’octet qui suit immédiatement le dernier octet valide dans le fichier.

AllocationSize

Nombre d’octets alloués pour le fichier. Cette valeur est généralement un multiple de la taille du secteur ou du cluster de l’appareil physique sous-jacent.

FileAttributes

Attributs de fichier. Ce membre peut être n’importe quelle combinaison valide des attributs suivants :

Valeur Signification
FILE_ATTRIBUTE_ARCHIVE
32 (0x20)
Fichier ou répertoire qui correspond à un fichier ou répertoire d’archive. Les applications utilisent habituellement cet attribut pour marquer des fichiers à des fins de sauvegarde ou de suppression. 
FILE_ATTRIBUTE_COMPRESSED
2048 (0x800)
Fichier ou répertoire compressé. Pour un fichier, toutes les données qu’il contient sont compressées. Pour un répertoire, la compression est la valeur par défaut pour les fichiers ou sous-répertoires nouvellement créés.
FILE_ATTRIBUTE_DEVICE
64 (0x40)
L’utilisation de cette valeur est réservée au système.
FILE_ATTRIBUTE_DIRECTORY
16 (0x10)
Descripteur qui identifie un répertoire.
FILE_ATTRIBUTE_ENCRYPTED
16384 (0x4000)
Fichier ou répertoire chiffré. Pour un fichier, tous les flux de données qu’il contient sont chiffrés. Pour un répertoire, le chiffrement est la valeur par défaut pour les fichiers ou sous-répertoires nouvellement créés.
FILE_ATTRIBUTE_HIDDEN
2 (0x2)
Le fichier ou répertoire est masqué. Il n’est pas inclus dans une liste de répertoires classique.
FILE_ATTRIBUTE_NORMAL
128 (0x80)
Fichier qui n’a pas d’autres attributs définis. Cet attribut est uniquement valide quand il est utilisé seul.
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
8192 (0x2000)
Le fichier ou répertoire ne doit pas être indexé par le service d’indexation de contenu.
FILE_ATTRIBUTE_OFFLINE
4096 (0x1000)
Les données d’un fichier ne sont pas disponibles immédiatement. Cet attribut indique que les données du fichier sont physiquement déplacées vers le stockage hors connexion. Cet attribut est utilisé par Stockage étendu, qui est le logiciel de gestion du stockage hiérarchique. Les applications ne doivent pas modifier arbitrairement cet attribut.
FILE_ATTRIBUTE_READONLY
1 (0x1)
Fichier en lecture seule. Les applications peuvent lire le fichier, mais elles ne peuvent pas y écrire ni le supprimer. Cet attribut n’est pas honoré sur des répertoires. Pour plus d’informations, consultez Vous ne pouvez pas afficher ou modifier les attributs Lecture seule ou Système des dossiers dans Windows Server 2003, Windows XP, Windows Vista ou Windows 7.
FILE_ATTRIBUTE_REPARSE_POINT
1024 (0x400)
Fichier ou répertoire qui a un point d’analyse associé ou fichier qui est un lien symbolique.
FILE_ATTRIBUTE_SPARSE_FILE
512 (0x200)
Fichier partiellement alloué.
FILE_ATTRIBUTE_SYSTEM
4 (0x4)
Fichier ou répertoire dont le système d’exploitation utilise une partie ou qu’il utilise exclusivement.
FILE_ATTRIBUTE_TEMPORARY
256 (0x100)
Fichier utilisé pour le stockage temporaire. Les systèmes de fichiers évitent de récrire des données dans le stockage de masse si la mémoire cache disponible est suffisante, car en général, une application supprime un fichier temporaire une fois le descripteur fermé. Dans ce scénario, le système peut entièrement éviter d’écrire les données. Sinon, les données sont écrites après la fermeture du descripteur.
FILE_ATTRIBUTE_VIRTUAL
65536 (0x10000)
L’utilisation de cette valeur est réservée au système.

FileNameLength

Longueur du nom de fichier.

EaSize

Taille des attributs étendus pour le fichier.

ReparsePointTag

Si le membre FileAttributes inclut l’attribut FILE_ATTRIBUTE_REPARSE_POINT , ce membre spécifie la balise de point d’analyse.

Sinon, cette valeur n’est pas définie et ne doit pas être utilisée.

Pour plus d’informations, consultez Balises de point d’analyse.

IO_REPARSE_TAG_CSV (0x80000009)

IO_REPARSE_TAG_DEDUP (0x80000013)

IO_REPARSE_TAG_DFS (0x8000000A)

IO_REPARSE_TAG_DFSR (0x80000012)

IO_REPARSE_TAG_HSM (0xC0000004)

IO_REPARSE_TAG_HSM2 (0x80000006)

IO_REPARSE_TAG_MOUNT_POINT (0xA0000003)

IO_REPARSE_TAG_NFS (0x80000014)

IO_REPARSE_TAG_SIS (0x80000007)

IO_REPARSE_TAG_WIM (0x80000008)

FileId

ID de fichier.

FileName[1]

Premier caractère de la chaîne de nom de fichier. Ceci est suivi en mémoire par le reste de la chaîne.

Configuration requise

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

Voir aussi

FILE_ID_128

FILE_INFO_BY_HANDLE_CLASS

Structures de gestion des fichiers

GetFileInformationByHandleEx