WIN32_FIND_DATA结构描述了由FindFirstFile或FindNextFile功能找到的文件。
typedef struct _WIN32_FIND_DATA { // WFD
DWORD dwFileAttributes;
FILETIME ftCreationTime;
FILETIME ftLastAccessTime;
FILETIME ftLastWriteTime;
DWORD nFileSizeHigh;
DWORD nFileSizeLow;
DWORD dwReserved0;
DWORD dwReserved1;
TCHAR cFileName[ MAX_PATH ];
TCHAR cAlternateFileName[ 14 ];
} WIN32_FIND_DATA;
会员
dwFileAttributes
指定找到的文件的文件属性。该成员可以是以下一个或多个值:
值 | 含义 | ||||
FILE_ATTRIBUTE_ARCHIVE | |||||
该文件是一个归档文件。应用程序使用此值来标记文件进行备份或删除。 | |||||
FILE_ATTRIBUTE_COMPRESSED | |||||
文件或目录被压缩。对于一个文件,这意味着文件中的所有数据都被压缩。对于目录,这意味着压缩是新创建的文件和子目录的默认压缩。 | |||||
FILE_ATTRIBUTE_DIRECTORY | |||||
该文件是一个目录。 | |||||
FILE_ATTRIBUTE_HIDDEN | |||||
该文件被隐藏。它不包括在普通目录列表中。 | |||||
FILE_ATTRIBUTE_NORMAL | |||||
该文件没有设置其他属性。此值仅在单独使用时有效。 | |||||
FILE_ATTRIBUTE_OFFLINE | |||||
该文件的数据不能立即可用。表示文件数据已被物理移动到离线存储。 | |||||
FILE_ATTRIBUTE_READONLY | |||||
该文件是只读的。应用程序可以读取文件,但无法写入或删除它。 | |||||
FILE_ATTRIBUTE_SYSTEM | |||||
该文件是操作系统的一部分,或由它专门使用。 | |||||
FILE_ATTRIBUTE_TEMPORARY | |||||
该文件正在用于临时存储。应用程序只有在绝对必要时才写入该文件。文件的大部分数据保留在内存中,而不会被刷新到媒体,因为该文件将很快被删除。 |
ftCreationTime
指定包含文件创建时间的FILETIME结构。FindFirstFile和FindNextFile以协调世界时(UTC)格式报告文件时间。如果包含该文件的文件系统不支持此时间成员,这些功能将FILETIME成员设置为零。您可以使用FileTimeToLocalFileTime函数将UTC转换为本地时间,然后使用FileTimeToSystemTime函数将本地时间转换为SYSTEMTIME结构,其中包含月,日,年,工作日,小时的个别成员,分,秒,毫秒。
ftLastAccessTime
指定包含文件上次访问时间的FILETIME结构。时间是UTC格式如果文件系统不支持此时间成员,则FILETIME成员为零。
ftLastWriteTime
指定包含上次写入文件的时间的FILETIME结构。时间是UTC格式如果文件系统不支持此时间成员,则FILETIME成员为零。
nFileSizeHigh
指定文件大小的高阶DWORD(以字节为单位)。除非文件大小大于MAXDWORD,否则此值为零。文件的大小等于(nFileSizeHigh * MAXDWORD)+ nFileSizeLow.
nFileSizeLow
指定文件大小的低阶DWORD(以字节为单位)。
dwReserved0
留作将来使用。
DWORD EnumPrinterData(
留作将来使用。
cFileName
作为文件名称的以null结尾的字符串。
cAlternateFileName
作为文件的替代名称的以null结尾的字符串。该名称是经典的8.3(filename.ext)文件名格式。
备注
如果文件长文件名,则完整名称将显示在cFileName字段中,名称的8.3格式截断版本将显示在cAlternateFileName字段中。否则,cAlternateFileName为空。或者,您可以使用GetShortPathName函数查找文件名的8.3格式版本。
也可以看看
FindFirstFile, FindNextFile, FILETIME, FileTimeToLocalFileTime, FileTimeToSystemTime, GetShortPathName