通过

SearchTreeForFileW 函数 （dbghelp.h）

  • 项目

在目录树中搜索指定文件。

语法

BOOL IMAGEAPI SearchTreeForFileW(
  [in]  PCWSTR RootPath,
  [in]  PCWSTR InputPathName,
  [out] PWSTR  OutputPathBuffer
);

参数

[in] RootPath

函数应开始搜索文件的路径。

[in] InputPathName

要为其搜索函数的文件。 可以使用部分路径。

[out] OutputPathBuffer

指向接收找到的文件的完整路径的缓冲区的指针。 如果返回值 FALSE，则不修改此字符串。

返回值

如果函数成功，则返回值 TRUE。

如果函数失败，则返回值 FALSE。 若要检索扩展的错误信息，请调用 GetLastError。

言论

该函数搜索由 InputPathName 参数指定的文件，该参数从 RootPath 参数中指定的路径开始。 RootPath 中允许的最大路径深度为 32 个目录。 当函数在目录树中查找文件时，它将文件的完整路径放置在由 OutputPathBuffer 参数指定的缓冲区中。 基础文件系统指定子目录搜索的顺序。

如果注册了 SymRegisterCallbackProc64 回调函数，则可以取消搜索。 对于搜索的每个目录，SearchTreeForFile 使用 CBA_DEFERRED_SYMBOL_LOAD_CANCEL 调用此回调函数。 如果回调函数返回 TRUE，SearchTreeForFile 取消搜索。

此函数按搜索的目录触发一个CBA_DEFERRED_SYMBOL_LOAD_CANCEL事件。 这允许调用方取消搜索。

所有 DbgHelp 函数（如此函数）都是单线程的。 因此，从多个线程调用此函数可能会导致意外行为或内存损坏。 若要避免这种情况，必须将来自多个线程的所有并发调用同步到此函数。

若要调用此函数的 Unicode 版本，请定义DBGHELP_TRANSLATE_TCHAR。

注意

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

要求

要求 价值
目标平台 窗户
标头 dbghelp.h
库 Dbghelp.lib
DLL Dbghelp.dll
可再发行组件 DbgHelp.dll 5.1 或更高版本

另请参阅

DbgHelp 函数