Función UpdateDebugInfoFile (imagehlp.h)
Usa la información especificada para actualizar los campos correspondientes en el archivo de símbolos.
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 |