Função UpdateDebugInfoFile (imagehlp.h)
Usa as informações especificadas para atualizar os campos correspondentes no arquivo de símbolo.
Sintaxe
BOOL IMAGEAPI UpdateDebugInfoFile(
[in] PCSTR ImageFileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath,
[in] PIMAGE_NT_HEADERS32 NtHeaders
);
Parâmetros
[in] ImageFileName
O nome da imagem que agora está desatualizada em relação ao arquivo de símbolo.
[in] SymbolPath
O caminho no qual procurar o arquivo de símbolo.
[out] DebugFilePath
Um ponteiro para um buffer que recebe o nome do arquivo de símbolo que foi atualizado.
[in] NtHeaders
Um ponteiro para uma estrutura IMAGE_NT_HEADERS que especifica as novas informações de cabeçalho.
Retornar valor
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
A função UpdateDebugInfoFile usa as informações armazenadas na estrutura IMAGE_NT_HEADERS e atualiza os campos correspondentes no arquivo de símbolo. Sempre que um arquivo de imagem é modificado, essa função deve ser chamada para manter os números sincronizados. Especificamente, sempre que uma soma de verificação de imagem for alterada, o arquivo de símbolo deverá ser atualizado para corresponder.
Todas as funções ImageHlp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | imagehlp.h |
| Biblioteca | Imagehlp.lib |
| DLL | Imagehlp.dll |