Função MapDebugInformation (dbghelp.h)
Obtém acesso às informações de depuração de uma imagem.
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.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Windows |
Cabeçalho | dbghelp.h |
Biblioteca | Dbghelp.lib |
DLL | Dbghelp.dll |
Redistribuível | DbgHelp.dll 5.1 ou posterior |