Função FindDebugInfoFileEx (dbghelp.h)
Localiza o arquivo de depuração especificado (.dbg).
Sintaxe
HANDLE IMAGEAPI FindDebugInfoFileEx(
[in] PCSTR FileName,
[in] PCSTR SymbolPath,
[out] PSTR DebugFilePath,
[in, optional] PFIND_DEBUG_FILE_CALLBACK Callback,
[in, optional] PVOID CallerData
);
Parâmetros
[in] FileName
O nome do arquivo .dbg a ser localizado. Você pode usar um caminho parcial.
[in] SymbolPath
O caminho onde os arquivos de símbolo estão localizados. Pode ser vários caminhos separados por ponto e vírgula. Para recuperar o caminho do símbolo, use a função SymGetSearchPath .
[out] DebugFilePath
Um ponteiro para um buffer que recebe o caminho completo do arquivo .dbg.
[in, optional] Callback
Uma função de retorno de chamada definida pelo aplicativo que verifica se o arquivo correto foi encontrado ou se a função deve continuar sua pesquisa. Para obter mais informações, consulte FindDebugInfoFileProc.
Esse parâmetro pode ser NULL.
[in, optional] CallerData
Dados opcionais definidos pelo usuário para passar para a função de retorno de chamada.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um identificador aberto para o arquivo .dbg.
Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
A função FindDebugInfoFileEx é usada para localizar um arquivo .dbg. Essa função é fornecida para que a pesquisa possa ser realizada em vários diretórios diferentes por meio de uma única chamada de função. O parâmetro SymbolPath pode conter vários caminhos, com cada um separado por ponto e vírgula (;). Quando vários caminhos são especificados, a função pesquisa cada diretório especificado para o arquivo. Quando o arquivo está localizado, a pesquisa é interrompida. Portanto, especifique SymbolPath com os caminhos na ordem correta.
Se o nome do arquivo especificado não incluir uma extensão .dbg, FindDebugInfoFileEx pesquisará o arquivo na seguinte sequência:
- SymbolPath\Symbols\ext\filename.dbg
- SymbolPath\ext\filename.dbg
- SymbolPath\filename.dbg
- FileNamePath\filename.dbg
Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR.
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 |