Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

FILE_INTERNAL_INFORMATION structure

The FILE_INTERNAL_INFORMATION structure is used to query for the file system's 8-byte file reference number for a file.

Syntax


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

Members

IndexNumber

The 8-byte file reference number for the file. This number is assigned by the file system and is file-system-specific. (Note that this is not the same as the 16-byte "file object ID" that was added to NTFS for Microsoft Windows 2000.)

Remarks

This information can be queried in either of the following ways:

No specific access rights are required to query this information.

The IndexNumber member of the FILE_INTERNAL_INFORMATION structure is the same as the FileId member of the FILE_ID_BOTH_DIR_INFORMATION and FILE_ID_FULL_DIR_INFORMATION structures.

File reference numbers, also called file IDs, are guaranteed to be unique only within a static file system. They are not guaranteed to be unique over time, because file systems are free to reuse them. Nor are they guaranteed to remain constant. For example, the FAT file system generates the file reference number for a file from the byte offset of the file's directory entry record (DIRENT) on the disk. Defragmentation can change this byte offset. Thus a FAT file reference number can change over time.

The size of the buffer passed in the FileInformation parameter to FltQueryInformationFile or ZwQueryInformationFile must be at least sizeof (FILE_INTERNAL_INFORMATION).

This structure must be aligned on a LONGLONG (8-byte) boundary.

Requirements

Header

Ntifs.h (include Ntifs.h or Fltkernel.h)

See also

FILE_ID_BOTH_DIR_INFORMATION
FILE_ID_FULL_DIR_INFORMATION
FILE_OBJECTID_INFORMATION
FltQueryInformationFile
ZwQueryInformationFile

 

 

Send comments about this topic to Microsoft

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.