共用方式為

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 函式