共用方式為

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 或更新版本

另請參閱

DbgHelp 函式