UnmapDebugInformation function (dbghelp.h)

Article
10/13/2021

Deallocates the memory and resources allocated by a call to the MapDebugInformation function.

Note This function is provided only for backward compatibility. New applications should use the SymUnloadModule64 function.

Syntax

BOOL IMAGEAPI UnmapDebugInformation(
  [in] PIMAGE_DEBUG_INFORMATION DebugInfo
);

Parameters

[in] DebugInfo

A pointer to an IMAGE_DEBUG_INFORMATION structure that is returned from a call to MapDebugInformation.

Return value

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. To retrieve extended error information, call GetLastError.

Remarks

The UnmapDebugInformation function is the counterpart to the MapDebugInformation function and must be used to deallocate the memory and resources allocated by a call to the MapDebugInformation function.

All DbgHelp functions, such as this one, are single threaded. Therefore, calls from more than one thread to this function will likely result in unexpected behavior or memory corruption. To avoid this, you must synchronize all concurrent calls from more than one thread to this function.

Requirements

Requirement	Value
Target Platform	Windows
Header	dbghelp.h
Library	Dbghelp.lib
DLL	Dbghelp.dll
Redistributable	DbgHelp.dll 5.1 or later