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.