structure FILE_INTERNAL_INFORMATION (ntifs.h)
La structure FILE_INTERNAL_INFORMATION est utilisée pour interroger 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 du fichier de 8 octets pour le fichier. Ce numéro est attribué par le système de fichiers et est spécifique au système de fichiers. (Notez que ce n’est pas la même chose que l'« ID d’objet de fichier » de 16 octets qui a été 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 transmettant FileInternalInformation comme valeur de FileInformationClass et en passant une mémoire tampon FILE_INTERNAL_INFORMATION structurée alloué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 membre IndexNumber 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 pour être uniques uniquement au sein d’un système de fichiers statique. Il n’est pas garanti qu’ils soient uniques au fil du temps, car les systèmes de fichiers sont libres de les réutiliser. Ils ne sont pas non plus assurés de rester constants. Par exemple, le système de fichiers FAT génère le numéro de référence d’un fichier à partir du décalage d’octet de l’enregistrement d’entrée de répertoire (DIRENT) du fichier 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).
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntifs.h (include Ntifs.h, Fltkernel.h) |