Função FindDebugInfoFile (dbghelp.h)

Localiza um arquivo de depuração (.dbg).

Para fornecer uma função de retorno de chamada para verificar o arquivo de símbolo localizado, use a função FindDebugInfoFileEx .

Sintaxe

HANDLE IMAGEAPI FindDebugInfoFile(
  [in]  PCSTR FileName,
  [in]  PCSTR SymbolPath,
  [out] PSTR  DebugFilePath
);

Parâmetros

[in] FileName

O nome do arquivo .dbg desejado. Você pode usar um caminho parcial.

[in] SymbolPath

O caminho em que 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.

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 FindDebugInfoFile é 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 para o arquivo. Subdiretórios não são pesquisados. Quando o arquivo está localizado, a pesquisa é interrompida. Portanto, especifique SymbolPath com os caminhos na ordem correta.

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

Confira também

Funções DbgHelp

FindDebugInfoFileEx

SymGetSearchPath