Funzione SymGetHomeDirectory (dbghelp.h)

Articolo
02/26/2024

Recupera la home directory utilizzata da Dbghelp.

Sintassi

PCHAR IMAGEAPI SymGetHomeDirectory(
  [in]  DWORD  type,
  [out] PSTR   dir,
  [in]  size_t size
);

Parametri

[in] type

Directory da recuperare. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
hdBase 0	Home directory.
hdSrc 2	Directory di origine.
hdSym 1	Directory dei simboli.

[out] dir

Puntatore a una stringa che riceve la directory.

[in] size

Dimensioni del buffer di output, in caratteri.

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

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

SymSetHomeDirectory

Condividi tramite