searchTreeForFile 函数 (dbghelp.h)

  • 项目

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

语法

BOOL IMAGEAPI SearchTreeForFile(
  [in]  PCSTR RootPath,
  [in]  PCSTR InputPathName,
  [out] PSTR  OutputPathBuffer
);

参数

[in] RootPath

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

[in] InputPathName

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

[out] OutputPathBuffer

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

返回值

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

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

备注

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

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

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

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

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

要求

   
目标平台 Windows
标头 dbghelp.h
Library Dbghelp.lib
DLL Dbghelp.dll
可再发行组件 DbgHelp.dll 5.1 或更高版本

请参阅

DbgHelp 函数