FindDebugInfoFile 函式（dbghelp.h）

找到除錯檔案（.dbg）。

若要提供回調函式來驗證符號檔案的定位，請使用 FindDebugInfoFileEx 函式。

語法

HANDLE IMAGEAPI FindDebugInfoFile(
  [in]  PCSTR FileName,
  [in]  PCSTR SymbolPath,
  [out] PSTR  DebugFilePath
);

Parameters

[in] FileName

想要的 .dbg 檔案名稱。 你可以使用部分路徑。

[in] SymbolPath

符號檔案所在的路徑。 這可能是多條路徑，中間用分號分隔。 要取得符號路徑，請使用 SymGetSearchPath 函式。

[out] DebugFilePath

一個指向緩衝區的指標，接收 .dbg 檔案的完整路徑。 此緩衝區必須至少為MAX_PATH+1個字元。

返回值

若函式成功，回傳值即為 .dbg 檔案的開啟句柄。

如果函式失敗，傳回值為 NULL。 若要擷取擴充的錯誤資訊，請呼叫 GetLastError。

備註

FindDebugInfoFile 函式用於定位 .dbg 檔案。 此功能的提供是為了讓搜尋能透過單一函式呼叫在多個不同的目錄中進行。 SymbolPath 參數可以包含多條路徑，每條路徑以分號（;) 分隔）。 當指定多條路徑時，函式會在每個目錄中搜尋該檔案。 子目錄不會被搜尋。 當檔案被找到後，搜尋即停止。 因此，務必將 SymbolPath 的路徑順序正確指定。

所有 DbgHelp 函式，例如這個，都是單執行緒。 因此，來自多個執行緒對此函式的呼叫，很可能導致意外行為或記憶體損毀。 為避免此情況，您必須將多個執行緒的所有同時呼叫同步至此函式。

要求

另請參閱

DbgHelp 函式

FindDebugInfoFileEx

SymGetSearchPath