Funzione SymSetHomeDirectory (dbghelp.h)

Imposta la home directory utilizzata da Dbghelp.

Sintassi

PCHAR IMAGEAPI SymSetHomeDirectory(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  dir
);

Parametri

[in] hProcess

Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .

[in, optional] dir

Home directory. Questa directory deve essere scrivibile; in caso contrario, la home directory è la directory dell'applicazione comune specificata con CSIDL_COMMON_APPDATA. Se questo parametro è NULL, la funzione usa la directory predefinita.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore al parametro dir .

Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

La home directory predefinita è la directory in cui risiede Dbghelp.dll. Dbghelp usa questa directory come base per altre directory, ad esempio la directory dell'archivio downstream predefinita (sottodirectory sym della home directory).

La home directory usata per l'archivio simboli predefinito e il percorso della cache del server di origine viene archiviato nella variabile di ambiente DBGHELP_HOMEDIR.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 6.1 o versione successiva

Vedi anche

Funzioni DbgHelp

SymGetHomeDirectory