FILE_STAT_BASIC_INFORMATION結構 （ntifs.h）

FILE_STAT_BASIC_INFORMATION 包含檔案的基本元數據。

語法

typedef struct _FILE_STAT_BASIC_INFORMATION {
  LARGE_INTEGER FileId;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER AllocationSize;
  LARGE_INTEGER EndOfFile;
  ULONG         FileAttributes;
  ULONG         ReparseTag;
  ULONG         NumberOfLinks;
  ULONG         DeviceType;
  ULONG         DeviceCharacteristics;
  ULONG         Reserved;
  LARGE_INTEGER VolumeSerialNumber;
  FILE_ID_128   FileId128;
} FILE_STAT_BASIC_INFORMATION, *PFILE_STAT_BASIC_INFORMATION;

成員

FileId

指定檔案的識別碼。

CreationTime

指定檔案的建立時間。

LastAccessTime

指定上次存取檔案的時間。

LastWriteTime

指定上次寫入檔案的時間。

ChangeTime

指定上次變更檔案的時間。

AllocationSize

檔案配置大小，以位元組為單位。 此值通常是基礎實體裝置的扇區或叢集大小的倍數。

EndOfFile

絕對新的檔尾位置，做為檔案開頭的位元組位移。 EndOfFile 指定檔案結尾的位元組位移。 因為這個值是以零起始，所以實際上會參考檔案中的第一個可用位元組。 換句話說，EndOfFile 是緊接在檔案中最後一個有效位元組之後的位元組位移。

FileAttributes

檔案屬性，可以是下列任何有效的組合：

ReparseTag

指定重新剖析點的標記。 如需詳細資訊，請參閱 關於重新剖析點。

NumberOfLinks

指定檔案的連結數目。

DeviceType

當驅動程式呼叫 IoCreateDevice 時設定， 適合基礎裝置的類型。 如需詳細資訊，請參閱 指定裝置類型。

DeviceCharacteristics

裝置特性。 如需相關值的描述，請參閱 DEVICE_OBJECT。

Reserved

保留供系統使用。

VolumeSerialNumber

檔案所在磁碟區的序號。

FileId128

檔案的 128 位元組檔案參考編號。 這個數位是由文件系統產生並指派給檔案。

言論

這項資訊可透過下列其中一種方式進行查詢：

• 呼叫 ZwQueryDirectoryFile，傳遞 FileStatBasicInformation 做為 fileInformation Class 的值，並傳遞呼叫端配置的、FILE_ID_EXTD_DIR_INFORMATION結構化緩衝區作為 fileInformation 的值。

• 使用主要函式程式碼 IRP_MJ_DIRECTORY_CONTROL 和次要函式程式代碼IRP_MN_QUERY_DIRECTORY建立 IRP。

查詢此資訊不需要任何特定的訪問許可權。

檔案參考編號，也稱為檔案標識符，保證只在靜態文件系統內是唯一的。 它們不保證會隨著時間而是唯一的，因為文件系統可以自由重複使用它們。 他們也不保證保持不變。 例如，FAT 檔案系統會從磁碟上檔案目錄項目記錄 （DIRENT） 的位元組位移產生檔案的檔案參考編號。 重組可以變更此位元組位移。 因此，FAT 檔案參考編號可能會隨著時間而變更。

所有日期和時間都是絕對系統時間格式。 絕對系統時間是自 1601 年初以來的 100 奈秒間隔數目。

此結構必須對齊 LONGLONG （8 位元組） 界限。 如果緩衝區包含兩個或多個這些結構，則每個專案中 NextEntryOffset 值，但最後一個值都落在 8 位元組界限上。

要求

另請參閱

FILE_INFORMATION_CLASS

ZwQueryInformationByName