На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

MapDebugInformation



The MapDebugInformation function gains access to the debug information for an image.

PIMAGE_DEBUG_INFORMATION MapDebugInformation(

IN HANDLE FileHandle,
IN LPSTR FileName,
IN LPSTR SymbolPath,
IN DWORD ImageBase
);


Parameters

FileHandle

A handle to an open executable image, a symbol file, or NULL.

FileName

The name of an executable image file, symbol file, or NULL.

SymbolPath

The path where symbol files are located. The path can be multiple paths, with each separated by a semicolon (;).

ImageBase

The base address for the image or zero.



Return Values

If the function succeeds, the return value is a pointer to an IMAGE_DEBUG_INFORMATION structure. This structure is allocated by IMAGEHLP and must be deallocated by IMAGEHLP through the use of the UnmapDebugInformation function. The memory for the structure is not in the process's default heap, so attempts to free it with any memory deallocation routine will fail.
If the function fails, the return value is NULL. To retrieve extended error information, call GetLastError.

Remarks

The MapDebugInformation function is used to gain access to an image's debug information. The debug information is extracted from the image or the symbol file and placed into the IMAGE_DEBUG_INFORMATION structure.


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

MapDebugInformation



Функция MapDebugInformation получает доступ к отладочной информации для образа.

PIMAGE_DEBUG_INFORMATION MapDebugInformation(

В РУЧКЕ FileHandle, В LPSTR FileName, В LPSTR SymbolPath, В DWORD ImageBase
);


Параметры

FileHandle

Ручка в открытый выполняемый образ, символьный файл, или НЕДЕЙСТВИТЕЛЬНЫЙ.

FileName

Имя выполняемого файла образа, символьного файла, или НЕДЕЙСТВИТЕЛЬНОЕ.

SymbolPath

Путь где символьные файлы расположены. Путь может быть многочисленными путями, с каждым разделенное точкой с запятой (;).

ImageBase

Базовый адрес для образа или нуля.



Обратные Величины

Если функция добивается успеха, обратная величина является указателем в структуру IMAGE_DEBUG_INFORMATION. Эта структура распределена IMAGEHLP и должно быть освобождено IMAGEHLP с помощью функции UnmapDebugInformation. Память для структуры - не в по умолчанию куче процесса, так что попытки, чтобы освобождать это с любой программой освобождения памяти потерпит неудачу.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы извлекать расширенную информацию ошибки, назовите GetLastError.

Замечания

Функция MapDebugInformation использована, чтобы приобретать доступ к отладочной информации образа. Отладочная информация извлечена из образа или символьный файл и установлена в структуру IMAGE_DEBUG_INFORMATION.


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz