Index   Commented   Search   About

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
imagehlp.lib
Header File
imagehlp.h
Unicode
No
Platform Notes
Windows 95: IMAGEHLP is available as a redistributable.

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.

Related Links

Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET

More Online Helps

Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages

Free Tech Secrets ;) Copyright © 2008 Free Tect Secrets ;) greatis just4fun network just4fun