Compartilhar via


Função UpdateDebugInfoFile (imagehlp.h)

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

Nota Essa função funciona com arquivos .dbg, não com arquivos .pdb.
 
Essa função foi substituída pela função UpdateDebugInfoFileEx . Use UpdateDebugInfoFileEx para verificar o valor da soma de verificação.

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

Confira também

IMAGE_NT_HEADERS

Funções ImageHlp

UpdateDebugInfoFileEx