WIN32_FIND_DATAA 结构 (minwinbase.h)

项目
01/10/2024

包含有关由 FindFirstFile、 FindFirstFileEx 或 FindNextFile 函数找到的文件的信息。

语法

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 文件名格式。

注解

如果文件具有长文件名，则完整名称将显示在 cFileName 成员中，并且该名称的 8.3 格式截断版本将显示在 cAlternateFileName 成员中。否则， cAlternateFileName 为空。如果在 fInfoLevelId 参数中使用 FindExInfoBasic 值调用 FindFirstFileEx 函数，则 cAlternateFileName 成员将始终包含 NULL 字符串值。对于对 FindNextFile 函数的所有后续调用，这一点保持不变。作为检索文件名的 8.3 格式版本的替代方法，可以使用 GetShortPathName 函数。有关文件名的详细信息，请参阅文件名、路径和命名空间。

并非所有文件系统都可以记录创建时间和上次访问时间，并非所有文件系统都以相同的方式记录它们。例如，在 FAT 文件系统上，创建时间的分辨率为 10 毫秒，写入时间的分辨率为 2 秒，访问时间的分辨率为 1 天。 NTFS 文件系统将文件上次访问时间的更新延迟到上次访问后最多 1 小时。有关详细信息，请参阅文件时间。

注意

minwinbase.h 标头将WIN32_FIND_DATA定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
标头	minwinbase.h (包括 Windows.h)