Função SymSetHomeDirectory (dbghelp.h)
Define o diretório base usado por Dbghelp.
Sintaxe
PCHAR IMAGEAPI SymSetHomeDirectory(
[in] HANDLE hProcess,
[in, optional] PCSTR dir
);
Parâmetros
[in] hProcess
Um identificador para um processo. Esse identificador deve ter sido passado anteriormente para a função SymInitialize .
[in, optional] dir
O diretório base. Esse diretório deve ser gravável, caso contrário, o diretório base é o diretório de aplicativo comum especificado com CSIDL_COMMON_APPDATA. Se esse parâmetro for NULL, a função usará o diretório padrão.
Retornar valor
Se a função for bem-sucedida, o valor retornado será um ponteiro para o parâmetro dir .
Se a função falhar, o valor retornado será NULL. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
O diretório base padrão é o diretório no qual Dbghelp.dll reside. Dbghelp usa esse diretório como base para outros diretórios, como o diretório padrão do repositório downstream (o subdiretório sym do diretório base).
O diretório inicial usado para o repositório de símbolos padrão e o local do cache do servidor de origem é armazenado na variável de ambiente DBGHELP_HOMEDIR.
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.1 ou posterior |