Função SymGetSymbolFile (dbghelp.h)

Localiza um arquivo de símbolo no caminho de símbolo especificado.

Sintaxe

BOOL IMAGEAPI SymGetSymbolFile(
  [in, optional] HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  ImageFile,
  [in]           DWORD  Type,
  [out]          PSTR   SymbolFile,
  [in]           size_t cSymbolFile,
  [out]          PSTR   DbgFile,
  [in]           size_t cDbgFile
);

Parâmetros

[in, optional] hProcess

Um identificador para o processo que foi originalmente passado para a função SymInitialize .

Se esse identificador for 0, SymPath não poderá ser NULL. Use essa opção para carregar um arquivo de símbolo sem chamar SymInitialize ou SymCleanup.

[in, optional] SymPath

O caminho do símbolo. Se esse parâmetro for NULL ou uma cadeia de caracteres vazia, a função usará o caminho do símbolo definido usando a função SymInitialize ou SymSetSearchPath .

[in] ImageFile

O nome do arquivo de imagem.

[in] Type

O tipo de arquivo de símbolo. Esse parâmetro pode usar um dos valores a seguir.

[out] SymbolFile

Um ponteiro para uma cadeia de caracteres terminada em nulo que recebe o nome do arquivo de símbolo.

[in] cSymbolFile

O tamanho do buffer SymbolFile , em caracteres.

[out] DbgFile

Um ponteiro para um buffer que recebe o caminho totalmente qualificado para o arquivo de símbolo. Esse buffer deve ter pelo menos MAX_PATH caracteres.

[in] cDbgFile

O tamanho do buffer DbgFile , em caracteres.

Valor retornado

Se o servidor localizar um arquivo de símbolo válido, ele retornará TRUE; caso contrário, ele retorna FALSE e GetLastError retorna um valor que indica por que o arquivo de símbolo não foi retornado.

Comentários

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.

Para chamar a versão Unicode dessa função, defina DBGHELP_TRANSLATE_TCHAR.

Requisitos

Confira também

Funções DbgHelp

SymInitialize