Compartilhar via

Função UpdateDebugInfoFileEx (imagehlp.h)

  • Artigo

Usa as informações estendidas especificadas para atualizar os campos correspondentes no arquivo de símbolo.

Nota Essa função funciona com arquivos .dbg, não com arquivos .pdb.
 

Sintaxe

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

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.

[in] OldCheckSum

O valor da soma de verificação original. Se esse valor não corresponder à soma de verificação presente na imagem mapeada, os sinalizadores no arquivo de símbolo conterão IMAGE_SEPARATE_DEBUG_MISMATCH e o último valor de erro será definido como ERROR_INVALID_DATA.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE.

Comentários

A função UpdateDebugInfoFileEx 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

Confira também

IMAGE_NT_HEADERS

Funções ImageHlp