Função SymSetHomeDirectoryW (dbghelp.h)
Define o diretório base usado por Dbghelp.
Sintaxe
PWSTR IMAGEAPI SymSetHomeDirectoryW(
[in] HANDLE hProcess,
[in, optional] PCWSTR 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.
Valor de retorno
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.
Observações
O diretório base padrão é o diretório no qual reside Dbghelp.dll. O 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 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 SymSetHomeDirectory 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.1 ou posterior |
Consulte também
SymGetHomeDirectory