FindDebugInfoFile 函式 (dbghelp.h)

發行項
02/29/2024

若要提供回呼函式來驗證找到的符號檔，請使用 FindDebugInfoFileEx 函式。

語法

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

參數

[in] FileName

所需的 .dbg 檔名。您可以使用部分路徑。

[in] SymbolPath

符號檔所在的路徑。這可以是以分號分隔的多個路徑。若要擷取符號路徑，請使用 SymGetSearchPath 函式。

[out] DebugFilePath

接收 .dbg 檔案完整路徑之緩衝區的指標。

傳回值

如果函式成功，則傳回值是 .dbg 檔案的開啟句柄。

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

備註

FindDebugInfoFile 函式可用來尋找 .dbg 檔案。提供此函式，以便透過單一函式呼叫，在數個不同的目錄中進行搜尋。 SymbolPath 參數可以包含多個路徑，每個路徑各以分號分隔 (;) 。指定多個路徑時，函式會搜尋每個目錄的檔案。未搜尋子目錄。當檔案位於時，搜尋會停止。因此，請務必以正確的順序指定 SymbolPath 與路徑。

所有 DbgHelp 函式，例如此函式都是單個線程。因此，從多個線程呼叫此函式可能會導致非預期的行為或記憶體損毀。若要避免這種情況，您必須將所有並行呼叫從多個線程同步處理到此函式。