FindNextFileW 函数 (fileapi.h)

从上一次调用 FindFirstFile、 FindFirstFileEx 或 FindFirstFileTransacted 函数继续文件搜索。

语法

BOOL FindNextFileW(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAW lpFindFileData
);

[in] hFindFile

先前调用 FindFirstFile 或 FindFirstFileEx 函数返回的搜索句柄。

[out] lpFindFileData

指向 WIN32_FIND_DATA 结构的指针，该结构接收有关找到的文件或子目录的信息。

如果函数成功，则返回值为非零值， 并且 lpFindFileData 参数包含有关找到的下一个文件或目录的信息。

如果函数失败，则返回值为零， 并且 lpFindFileData 的内容不确定。若要获得更多的错误信息，请调用 GetLastError 函数。

如果函数因找不到更多匹配文件而失败， GetLastError 函数将返回 ERROR_NO_MORE_FILES。

此函数使用用于创建 hFindFile 参数中传递的搜索句柄的相同搜索筛选器。有关详细信息，请参阅 FindFirstFile 和 FindFirstFileEx。

无法保证搜索返回文件的顺序（如字母顺序），具体取决于文件系统。如果必须对数据进行排序，则应用程序必须在获取所有结果后执行排序。

注意在极少数情况下或在负载较重的系统上，在调用此函数时，NTFS 文件系统上的文件属性信息可能不是最新的。若要确保获取当前 NTFS 文件系统文件属性，请调用 GetFileInformationByHandle 函数。

此函数返回文件名的顺序取决于文件系统类型。对于 NTFS 文件系统和 CDFS 文件系统，名称通常按字母顺序返回。对于 FAT 文件系统，名称通常按文件写入磁盘的顺序返回，该顺序可能按字母顺序返回，也可能不按字母顺序返回。但是，如前所述，不能保证这些行为。

如果路径指向符号链接，WIN32_FIND_DATA 缓冲区包含有关符号链接而不是目标的信息。

在 Windows 8 和 Windows Server 2012 中，此函数由以下技术支持。

如果存在绑定到文件枚举句柄的事务，则返回的文件受事务隔离规则的约束。

有关示例，请参阅列出目录中的文件。

注意

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