Функция MapDebugInformation (dbghelp.h)

Статья
08/23/2023

Получает доступ к сведениям об отладке для образа.

Примечание Эта функция предоставляется только для обеспечения обратной совместимости. Он не возвращает достоверную информацию. Новые приложения должны использовать функции 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, такие как эта, являются однопоточными. Поэтому вызовы из нескольких потоков к этой функции, скорее всего, приведут к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, необходимо синхронизировать все параллельные вызовы из нескольких потоков в эту функцию.

Требования

Требование	Значение
Целевая платформа	Windows
Header	dbghelp.h
Библиотека	Dbghelp.lib
DLL	Dbghelp.dll
Распространяемые компоненты	DbgHelp.dll 5.1 или более поздней версии

См. также раздел

Функции DbgHelp

IMAGE_DEBUG_INFORMATION

SymGetSearchPath

UnmapDebugInformation

Поделиться через