Функция MapDebugInformation (dbghelp.h)
Получает доступ к сведениям об отладке для образа.
Синтаксис
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 или более поздней версии |