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。
備註
函式會搜尋 InputPathName 參數所指定的檔案，從 RootPath 參數中指定的路徑開始。 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 |
| 程式庫 | Dbghelp.lib |
| Dll | Dbghelp.dll |
| 可轉散發套件 | DbgHelp.dll 5.1 或更新版本 |