MapDebugInformation 函式 (dbghelp.h)

發行項
02/26/2024

取得映像偵錯資訊的存取權。

注意此函式僅供回溯相容性使用。它不會傳回可靠的資訊。新的應用程式應該使用 SymGetModuleInfo64 和 SymLoadModule64 函式。

語法

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

參數

[in, optional] FileHandle

開啟可執行檔映像或 NULL 的句柄。

[in] FileName

可執行檔映像檔或 NULL 的名稱。

[in, optional] SymbolPath

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

[in] ImageBase

映射或零的基位址。

傳回值

如果函式成功，則傳回值是 IMAGE_DEBUG_INFORMATION 結構的指標。

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

備註

MapDebugInformation 函式可用來取得影像偵錯資訊的存取權。偵錯資訊會從影像或符號檔擷取，並放入 IMAGE_DEBUG_INFORMATION 結構中。此結構是由連結庫所配置，而且必須使用 UnmapDebugInformation 函式解除配置。結構的記憶體不在進程的預設堆積中，因此嘗試釋放記憶體解除分配例程將會失敗。

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