WIN32_FIND_DATAA結構 (minwinbase.h)
包含 findFirstFile
語法
typedef struct _WIN32_FIND_DATAA {
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD dwReserved0;
DWORD dwReserved1;
CHAR cFileName[MAX_PATH];
CHAR cAlternateFileName[14];
DWORD dwFileType; // Obsolete. Do not use.
DWORD dwCreatorType; // Obsolete. Do not use
WORD wFinderFlags; // Obsolete. Do not use
} WIN32_FIND_DATAA, *PWIN32_FIND_DATAA, *LPWIN32_FIND_DATAA;
成員
dwFileAttributes
檔案的檔案屬性。
如需可能的值及其描述,請參閱 檔案屬性常數。
如果檔案的任何數據流都疏鬆,則會設定檔案上的 FILE_ATTRIBUTE_SPARSE_FILE 屬性。
ftCreationTime
FILETIME 結構,指定建立檔案或目錄的時間。
如果基礎文件系統不支援建立時間,則此成員為零。
ftLastAccessTime
FILETIME 結構。
針對檔案,結構會指定上次讀取、寫入或可執行檔的檔案何時執行。
針對目錄,結構會指定建立目錄的時間。 如果基礎文件系統不支援上次存取時間,則此成員為零。
在 FAT 檔案系統上,檔案和目錄的指定日期都正確,但一天中的時間一律設定為午夜。
ftLastWriteTime
FILETIME 結構。
針對檔案,結構會指定上次寫入、截斷或覆寫檔案的時間,例如,使用 WriteFile 或 SetEndOfFile 時。 檔案屬性或安全性描述項變更時,不會更新日期和時間。
針對目錄,結構會指定建立目錄的時間。 如果基礎文件系統不支援上次寫入時間,則此成員為零。
nFileSizeHigh
高階 DWORD 檔案大小的值,以位元組為單位。
除非檔案大小大於 MAXDWORD
檔案的大小等於 (nFileSizeHigh * (MAXDWORD+1)) + nFileSizeLow。
nFileSizeLow
低序 DWORD 檔案大小的值,以位元組為單位。
dwReserved0
如果 dwFileAttributes 成員包含 FILE_ATTRIBUTE_REPARSE_POINT 屬性,則此成員會指定重新分析點標記。
否則,這個值是未定義的,不應該使用。
如需詳細資訊,請參閱 重新剖析點標記。
IO_REPARSE_TAG_CSV(0x80000009)
IO_REPARSE_TAG_DEDUP (0x80000013)
IO_REPARSE_TAG_DFS (0x8000000A)
IO_REPARSE_TAG_DFSR(0x80000012)
IO_REPARSE_TAG_HSM (0xC0000004)
IO_REPARSE_TAG_HSM2(0x80000006)
IO_REPARSE_TAG_MOUNT_POINT(0xA0000003)
IO_REPARSE_TAG_NFS (0x80000014)
IO_REPARSE_TAG_SIS(0x80000007)
IO_REPARSE_TAG_SYMLINK (0xA000000C)
IO_REPARSE_TAG_WIM (0x80000008)
dwReserved1
保留供日後使用。
cFileName[MAX_PATH]
檔名。
cAlternateFileName[14]
檔案的替代名稱。
此名稱是傳統 8.3 檔名格式。
言論
如果檔案具有長檔名,則完整名稱會出現在
並非所有文件系統都可以記錄建立和上次存取時間,而且並非所有文件系統都以相同方式記錄它們。 例如,在 FAT 文件系統上,建立時間的解析度為 10 毫秒,寫入時間的解析度為 2 秒,而存取時間的解析度為 1 天。 NTFS 檔系統在上次存取后最多 1 小時,延遲檔案上次存取時間的更新。 如需詳細資訊,請參閱 File Times。
注意
minwinbase.h 標頭會將WIN32_FIND_DATA定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
支援的最低伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
標頭 | minwinbase.h (包括 Windows.h) |