Função SymGetSymbolFileW (dbghelp.h)

Artigo
11/20/2024

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

Sintaxe

BOOL IMAGEAPI SymGetSymbolFileW(
  [in, optional] HANDLE hProcess,
  [in, optional] PCWSTR SymPath,
  [in]           PCWSTR ImageFile,
  [in]           DWORD  Type,
  [out]          PWSTR  SymbolFile,
  [in]           size_t cSymbolFile,
  [out]          PWSTR  DbgFile,
  [in]           size_t cDbgFile
);

Parâmetros

[in, optional] hProcess

Um identificador para o processo que foi passado originalmente 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 conjunto de caminhos de símbolo 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 ser um dos valores a seguir.

Valor	Significado
sfImage 0	Um arquivo .exe ou .dll.
sfDbg 1	Um arquivo .dbg.
sfPdb 2	Um arquivo .pdb.
sfMpd 3	Reservado.

[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 ser pelo menos MAX_PATH caracteres.

[in] cDbgFile

O tamanho do buffer de DbgFile, em caracteres.

Valor de retorno

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

Observações

Todas as funções DbgHelp, como esta, são threaded simples. 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.

Nota

O cabeçalho dbghelp.h define SymGetSymbolFile 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 6.3 ou posterior

Consulte também

do DbgHelp Functions

SymInitialize

Compartilhar via