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 |