FILE_BASIC_INFORMATION 結構 (wdm.h)

發行項
03/05/2024

FILE_BASIC_INFORMATION 結構包含檔案的時間戳和基本屬性。它用來作為查詢或設定檔案資訊的例程自變數。

語法

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

成員

CreationTime

指定檔案建立的時間。

LastAccessTime

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

LastWriteTime

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

ChangeTime

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

FileAttributes

指定一或多個FILE_ATTRIBUTE_XXX 旗標。如需這些旗標的描述，請參閱 Microsoft Windows SDK 中的檔案屬性常數。

備註

無法與任何其他屬性一起設定或傳回FILE_ATTRIBUTE_NORMAL旗標。所有其他 FileAttributes 值都會覆寫這個屬性。

Time 值 CreationTime、 LastAccessTime、 LastWriteTime 和 ChangeTime 會以絕對系統時間格式表示。絕對系統時間是從公曆 1601 年開始以來的 100 奈秒間隔數目。

如果您為FILE_BASIC_INFORMATION結構的任何 XxxTime 成員指定零值，ZwSetInformationFile 函式會保留該時間的檔案目前設定。

文件系統會在檔案上執行 I/O 作業之後，視需要更新 LastAccessTime、 LastWriteTime 和 ChangeTime 成員的值。驅動程式或應用程式可以要求檔案系統不會針對呼叫端的檔案句柄上執行的 I/O 作業更新一或多個成員，方法是將適當的成員設定為 -1。呼叫端可以將這三個成員的一個、全部或任何其他組合設定為 -1。只有設定為 -1 的成員不會受到檔句柄上的 I/O 作業影響;其他成員會視需要更新。在NTFS和ReFS系統上，將適當的成員) (設定為 -2，即可還原檔句柄上的時間戳更新。

若要設定這個結構的成員，呼叫端必須具有檔案的存取權FILE_WRITE_ATTRIBUTES。