Share via

Función UpdateDebugInfoFile (imagehlp.h)

  • Artículo

Usa la información especificada para actualizar los campos correspondientes en el archivo de símbolos.

Nota Esta función funciona con archivos .dbg, no archivos .pdb.
 
Esta función se ha reemplazado por la función UpdateDebugInfoFileEx . Use UpdateDebugInfoFileEx para comprobar el valor de suma de comprobación.

Sintaxis

BOOL IMAGEAPI UpdateDebugInfoFile(
  [in]  PCSTR               ImageFileName,
  [in]  PCSTR               SymbolPath,
  [out] PSTR                DebugFilePath,
  [in]  PIMAGE_NT_HEADERS32 NtHeaders
);

Parámetros

[in] ImageFileName

Nombre de la imagen que ahora no está actualizada con respecto a su archivo de símbolos.

[in] SymbolPath

Ruta de acceso en la que se va a buscar el archivo de símbolos.

[out] DebugFilePath

Puntero a un búfer que recibe el nombre del archivo de símbolos que se actualizó.

[in] NtHeaders

Puntero a una estructura de IMAGE_NT_HEADERS que especifica la nueva información de encabezado.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

La función UpdateDebugInfoFile toma la información almacenada en la estructura IMAGE_NT_HEADERS y actualiza los campos correspondientes en el archivo de símbolos. Cada vez que se modifica un archivo de imagen, se debe llamar a esta función para mantener sincronizados los números. En concreto, cada vez que cambia una suma de comprobación de imagen, el archivo de símbolos debe actualizarse para que coincida.

Todas las funciones ImageHlp, 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.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imagehlp.h
Library Imagehlp.lib
Archivo DLL Imagehlp.dll

Consulte también

IMAGE_NT_HEADERS

Funciones ImageHlp

UpdateDebugInfoFileEx