Função SymSrvGetSupplement (dbghelp.h)
Recupera o arquivo especificado do suplemento para um repositório de símbolos.
Sintaxe
PCSTR IMAGEAPI SymSrvGetSupplement(
[in] HANDLE hProcess,
[in, optional] PCSTR SymPath,
[in] PCSTR Node,
[in] PCSTR File
);
Parâmetros
[in] hProcess
Um identificador para um processo. Esse identificador deve ter sido passado anteriormente para a função SymInitialize .
[in, optional] SymPath
O caminho do símbolo. A função usa apenas os repositórios de símbolos descritos na sintaxe padrão para repositórios de símbolos. Todos os outros caminhos são ignorados. Se esse parâmetro for NULL, a função usará o caminho do símbolo definido usando a função SymInitialize ou SymSetSearchPath .
[in] Node
O arquivo de símbolo associado ao arquivo complementar.
[in] File
O nome do arquivo.
Retornar valor
Se a função for bem-sucedida, o valor retornado será o caminho totalmente qualificado para o arquivo complementar.
Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
Para obter mais informações sobre arquivos complementares, consulte SymSrvStoreSupplement.
Essa função retorna um ponteiro para um buffer que pode ser reutilizado por outra função. Portanto, copie os dados retornados para outro buffer imediatamente.
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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | dbghelp.h |
| Biblioteca | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Redistribuível | DbgHelp.dll 6.3 ou posterior |