Função SymSetHomeDirectory (dbghelp.h)

  • Artigo

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

Confira também

Funções DbgHelp

SymGetHomeDirectory