Funzione SymGetSearchPath (dbghelp.h)

Recupera il percorso di ricerca dei simboli per il processo specificato.

Sintassi

BOOL IMAGEAPI SymGetSearchPath(
  [in]  HANDLE hProcess,
  [out] PSTR   SearchPath,
  [in]  DWORD  SearchPathLength
);

Parametri

[in] hProcess

Handle per il processo passato originariamente alla funzione SymInitialize .

[out] SearchPath

Puntatore al buffer che riceve il percorso di ricerca del simbolo.

[in] SearchPathLength

Dimensioni del buffer SearchPath , in caratteri.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

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

Commenti

La funzione SymGetSearchPath copia il percorso di ricerca dei simboli per il processo specificato nel buffer searchPath . Se la funzione ha esito negativo, il contenuto del buffer non è definito.

Per specificare un percorso di ricerca dei simboli per il processo, usare la funzione SymSetSearchPath .

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare 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

Vedi anche

Funzioni DbgHelp

SymInitialize

SymSetSearchPath