structure FILE_INTERNAL_INFORMATION (ntifs.h)

Article
02/07/2025

La structure FILE_INTERNAL_INFORMATION est utilisée pour rechercher le numéro de référence de fichier de 8 octets du système de fichiers pour un fichier.

Syntaxe

typedef struct _FILE_INTERNAL_INFORMATION {
  LARGE_INTEGER IndexNumber;
} FILE_INTERNAL_INFORMATION, *PFILE_INTERNAL_INFORMATION;

Membres

IndexNumber

Numéro de référence de fichier de 8 octets pour le fichier. Ce nombre est attribué par le système de fichiers et est spécifique au système de fichiers. (Notez que ce n’est pas le même que l'« ID d’objet de fichier » de 16 octets ajouté à NTFS pour Microsoft Windows 2000.)

Remarques

Ces informations peuvent être interrogées de l’une des manières suivantes :

Appelez FltQueryInformationFile ou ZwQueryInformationFile, en passant FileInternalInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_INTERNAL_INFORMATION structurée par l’appelant comme valeur de FileInformation.
Créez un IRP avec le code de fonction principal IRP_MJ_QUERY_INFORMATION.

Aucun droit d’accès spécifique n’est requis pour interroger ces informations.

Le IndexNumber membre de la structure FILE_INTERNAL_INFORMATION est identique au membre FileId des structures FILE_ID_BOTH_DIR_INFORMATION et FILE_ID_FULL_DIR_INFORMATION.

Les numéros de référence de fichier, également appelés ID de fichier, sont garantis d’être uniques uniquement dans un système de fichiers statique. Elles ne sont pas garanties d’être uniques au fil du temps, car les systèmes de fichiers sont libres de les réutiliser. Ils ne sont pas assurés de rester constants. Par exemple, le système de fichiers FAT génère le numéro de référence de fichier d’un fichier à partir du décalage d’octets de l’enregistrement d’entrée de répertoire du fichier (DIRENT) sur le disque. La défragmentation peut modifier ce décalage d’octet. Ainsi, un numéro de référence de fichier FAT peut changer au fil du temps.

La taille de la mémoire tampon passée dans le paramètre FileInformation à FltQueryInformationFile ou ZwQueryInformationFile doit être au moins sizeof(FILE_INTERNAL_INFORMATION).

Cette structure doit être alignée sur une limite LONGLONG (8 octets).