Función MapDebugInformation (dbghelp.h)

Artículo
08/23/2023

Obtiene acceso a la información de depuración de una imagen.

Nota Esta función solo se proporciona para la compatibilidad con versiones anteriores. No devuelve información confiable. Las nuevas aplicaciones deben usar las funciones SymGetModuleInfo64 y SymLoadModule64 .

Sintaxis

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

Parámetros

[in, optional] FileHandle

Identificador de una imagen ejecutable abierta o NULL.

[in] FileName

Nombre de un archivo de imagen ejecutable o NULL.

[in, optional] SymbolPath

Ruta de acceso donde se encuentran los archivos de símbolos. La ruta de acceso puede ser varias rutas separadas por punto y coma. Para recuperar la ruta de acceso del símbolo, use la función SymGetSearchPath .

[in] ImageBase

Dirección base de la imagen o cero.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un puntero a una estructura IMAGE_DEBUG_INFORMATION .

Si la función no se realiza correctamente, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

La función MapDebugInformation se usa para obtener acceso a la información de depuración de una imagen. La información de depuración se extrae de la imagen o del archivo de símbolos y se coloca en la estructura IMAGE_DEBUG_INFORMATION . La biblioteca asigna esta estructura y se debe desasignar mediante la función UnmapDebugInformation . La memoria de la estructura no está en el montón predeterminado del proceso, por lo que se producirá un error en los intentos de liberarla con una rutina de desasignación de memoria.

Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.