Função FindDebugInfoFileExW (dbghelp.h)
Localiza o arquivo de depuração especificado (.dbg).
Sintaxe
HANDLE IMAGEAPI FindDebugInfoFileExW(
[in] PCWSTR FileName,
[in] PCWSTR SymbolPath,
[out] PWSTR DebugFilePath,
[in, optional] PFIND_DEBUG_FILE_CALLBACKW 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.
Valor de retorno
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.
Observações
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 um 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 \nome de arquivo.dbg
- FileNamePath\nome de arquivo.dbg
Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR.
Nota
O cabeçalho dbghelp.h define FindDebugInfoFileEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
Requisito | Valor |
---|---|
da Plataforma de Destino |
Windows |
cabeçalho | dbghelp.h |
biblioteca | Dbghelp.lib |
de DLL |
Dbghelp.dll |
redistribuível | DbgHelp.dll 5.1 ou posterior |