BY_HANDLE_FILE_INFORMATION 結構 (fileapi.h)

  • 發行項

包含 GetFileInformationByHandle 函式擷取的資訊。

語法

typedef struct _BY_HANDLE_FILE_INFORMATION {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    dwVolumeSerialNumber;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    nNumberOfLinks;
  DWORD    nFileIndexHigh;
  DWORD    nFileIndexLow;
} BY_HANDLE_FILE_INFORMATION, *PBY_HANDLE_FILE_INFORMATION, *LPBY_HANDLE_FILE_INFORMATION;

成員

dwFileAttributes

檔案屬性。 如需可能的值及其描述，請參閱 檔案屬性常數。

ftCreationTime

FILETIME 結構，指定何時建立檔案或目錄。 如果基礎文件系統不支援建立時間，則此成員為零 (0) 。

ftLastAccessTime

FILETIME 結構。 針對檔案，結構會指定上次讀取或寫入檔案的時間。 針對目錄，結構會指定何時建立目錄。 針對檔案和目錄，指定的日期正確，但一天的時間一律會設定為午夜。 如果基礎文件系統不支援上次存取時間，則此成員為零 (0) 。

ftLastWriteTime

FILETIME 結構。 針對檔案，結構會指定上次寫入檔案的時間。 針對目錄，結構會指定何時建立目錄。 如果基礎文件系統不支援上次寫入時間，這個成員 (0) 。

dwVolumeSerialNumber

包含檔案之磁碟區的序號。

nFileSizeHigh

檔案大小的高階部分。

nFileSizeLow

檔案大小的低序部分。

nNumberOfLinks

此檔案的連結數目。 對於 FAT 檔系統，此成員一律為 1。 針對NTFS文件系統，它可以超過1。

nFileIndexHigh

與檔案相關聯的唯一標識符的高序部分。 如需詳細資訊，請參閱 nFileIndexLow。

nFileIndexLow

與檔案相關聯的唯一標識符低序部分。

標識子 (低和高部分) ，且磁碟區序號可唯一識別單一計算機上的檔案。 若要判斷兩個開啟的句柄是否代表相同的檔案，請合併每個檔案的標識碼和磁碟區序號，並加以比較。

由 Windows Server 2012 引進的 ReFS 檔系統包含 128 位檔案識別碼。 若要擷取 128 位檔案標識符，請使用 GetFileInformationByHandleEx 函式搭配 FileIdInfo 來擷取 FILE_ID_INFO 結構。 此結構中的64位標識符不保證在ReFS上是唯一的。

備註

儲存在 nFileIndexHigh 和 nFileIndexLow 成員中的標識碼稱為檔案識別碼。 檔案標識碼的支持是文件系統特定的。 檔案標識碼不保證在一段時間內是唯一的，因為文件系統可以自由重複使用。 在某些情況下，檔案的檔案標識碼可能會隨著時間而變更。

在 FAT 檔案系統中，檔案識別碼是從包含目錄的第一個叢集產生，以及檔案項目目錄中的位元組位移。 某些重組產品會變更此位元組位移。 (Windows 現成的重組不會。) 因此，FAT 檔案識別符可能會隨著時間而變更。 在 FAT 檔案系統中重新命名檔案也可以變更檔案識別碼，但只有在新檔名超過舊檔名時。

在NTFS檔案系統中，檔案會保留相同的檔案識別碼，直到刪除為止。 您可以使用 ReplaceFile 函式，以另一個檔案取代一個檔案，而不需變更檔案識別碼。 不過，取代檔案的檔案標識符，而不是已取代的檔案，會保留為所產生檔案的檔案標識碼。

並非所有文件系統都可以記錄建立和上次存取時間，而且並非所有文件系統都以相同的方式記錄它們。 例如，在 Windows FAT 檔系統上，建立時間的解析度為 10 毫秒、寫入時間解析度為 2 秒，而存取時間的解析度為 1 天， (存取日期) 。 在NTFS檔系統上，存取時間的解析度為1小時。 如需詳細資訊，請參閱 檔案時間。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
標頭 fileapi.h (包含 Windows.h)

另請參閱

FILETIME

FILE_ID_INFO

檔案屬性常數

GetFileInformationByHandle

GetFileInformationByHandleEx