Função MapDebugInformation (dbghelp.h)

Artigo
02/26/2024

Obtém acesso às informações de depuração de uma imagem.

Nota Essa função é fornecida apenas para compatibilidade com versões anteriores. Ele não retorna informações confiáveis. Novos aplicativos devem usar as funções SymGetModuleInfo64 e SymLoadModule64 .

Sintaxe

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

Parâmetros

[in, optional] FileHandle

Um identificador para uma imagem executável aberta ou NULL.

[in] FileName

O nome de um arquivo de imagem executável ou NULL.

[in, optional] SymbolPath

O caminho em que os arquivos de símbolo estão localizados. O caminho pode ser vários caminhos separados por ponto e vírgula. Para recuperar o caminho do símbolo, use a função SymGetSearchPath .

[in] ImageBase

O endereço base da imagem ou zero.

Retornar valor

Se a função for bem-sucedida, o valor retornado será um ponteiro para uma estrutura IMAGE_DEBUG_INFORMATION .

Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A função MapDebugInformation é usada para obter acesso às informações de depuração de uma imagem. As informações de depuração são extraídas da imagem ou do arquivo de símbolo e colocadas na estrutura IMAGE_DEBUG_INFORMATION . Essa estrutura é alocada pela biblioteca e deve ser desalocada usando a função UnmapDebugInformation . A memória da estrutura não está no heap padrão do processo, portanto, as tentativas de liberá-la com uma rotina de desalocação de memória falharão.

Todas as funções DbgHelp, 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.