SymFindDebugInfoFile 函式（dbghelp.h）

在程序搜尋路徑中定位一個 .dbg 檔案。

語法

HANDLE IMAGEAPI SymFindDebugInfoFile(
  [in]           HANDLE                    hProcess,
  [in]           PCSTR                     FileName,
  [out]          PSTR                      DebugFilePath,
  [in, optional] PFIND_DEBUG_FILE_CALLBACK Callback,
  [in, optional] PVOID                     CallerData
);

Parameters

[in] hProcess

一個原本傳遞給 SymInitialize 函式的程序的 handle 。

[in] FileName

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

[out] DebugFilePath

.dbg 檔案的完全限定路徑。 此緩衝區必須至少為MAX_PATH+1個字元。

[in, optional] Callback

一個應用程式定義的回調函式，用來驗證是否找到正確的檔案，或是函式應該繼續搜尋。 欲了解更多資訊，請參閱 FindDebugInfoFileProc。

此參數可以是 NULL。

[in, optional] CallerData

使用者定義的值或 NULL。 這個值會直接傳遞給回調函式。 這個參數通常被應用程式用來傳遞指標到提供回調函式上下文的資料結構。

返回值

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

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

備註

此函式使用搜尋路徑集合，使用 SymInitialize 或 SymSetSearchPath 函式。

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

要呼叫此函式的 Unicode 版本，請定義 DBGHELP_TRANSLATE_TCHAR。

要求

另請參閱

DbgHelp 函式

FindDebugInfoFileProc