FindFirstFileExFromAppW 函数 (fileapifromapp.h)

  • 项目

在目录中搜索名称和属性与指定的名称和属性匹配的文件或子目录。 此函数的行为与 FindFirstFileEx 相同，只不过此函数遵循通用 Windows 平台应用安全模型。

语法

WINSTORAGEAPI HANDLE FindFirstFileExFromAppW(
  LPCWSTR            lpFileName,
  FINDEX_INFO_LEVELS fInfoLevelId,
  LPVOID             lpFindFileData,
  FINDEX_SEARCH_OPS  fSearchOp,
  LPVOID             lpSearchFilter,
  DWORD              dwAdditionalFlags
) noexcept;

参数

lpFileName

目录或路径，以及文件名。 文件名可以包含通配符，例如星号 (*) 或问号 (？) 。

此参数不应为 NULL、无效字符串 (例如，空字符串或缺少终止 null 字符的字符串) ，或以尾随反斜杠 (\) 结尾。

如果字符串以通配符、句点或目录名称结尾，则用户必须有权访问路径上的根目录和所有子目录。

有关在不附加“\\？\”的情况下选择退出 MAX_PATH 限制的信息，请参阅 命名文件、路径和命名空间 的“最大路径长度限制”部分以了解详细信息。

fInfoLevelId

返回的数据的信息级别。

此参数是 FINDEX_INFO_LEVELS 枚举值之一。

lpFindFileData

指向接收文件数据的缓冲区的指针。

指针类型由 fInfoLevelId 参数中指定的信息级别决定。

fSearchOp

要执行的筛选类型与通配符匹配不同。

此参数是 FINDEX_SEARCH_OPS 枚举值之一。

lpSearchFilter

如果指定的 fSearchOp 需要结构化搜索信息，则为指向搜索条件的指针。

目前，任何受支持的 fSearchOp 值都不需要扩展搜索信息。 因此，此指针必须为 NULL。

dwAdditionalFlags

指定控制搜索的其他标志。

值 含义
FIND_FIRST_EX_CASE_SENSITIVE 1

搜索区分大小写。
FIND_FIRST_EX_LARGE_FETCH 2

对目录查询使用更大的缓冲区，这可以提高查找操作的性能。
FIND_FIRST_EX_ON_DISK_ENTRIES_ONLY 4

将结果限制为物理位于磁盘上的文件。 仅当存在文件虚拟化筛选器时，此标志才相关。

返回值

如果函数成功，则返回值是后续调用 FindNextFile 或 FindClose 中使用的搜索句柄， lpFindFileData 参数包含有关找到的第一个文件或目录的信息。

如果函数失败或未能从 lpFileName 参数中的搜索字符串中找到文件，则返回值 INVALID_HANDLE_VALUE 且 lpFindFileData 的内容不确定。 若要获得更多的错误信息，请调用 GetLastError 函数。

要求

要求 值
最低受支持的客户端 Windows 10 版本 1803
标头 fileapifromapp.h