Funzione SymGetSearchPathW (dbghelp.h)

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

Sintassi

BOOL IMAGEAPI SymGetSearchPathW(
  [in]  HANDLE hProcess,
  [out] PWSTR  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 dei simboli.

[in] SearchPathLength

Dimensioni del buffer di SearchPath, in caratteri.

Valore restituito

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

Se la funzione non riesce, il valore restituito viene FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Osservazioni

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 genereranno probabilmente 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.

Nota

L'intestazione dbghelp.h definisce SymGetSearchPath come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	dbghelp.h
libreria	Dbghelp.lib
dll	Dbghelp.dll
Ridistribuibile	DbgHelp.dll 5.1 o versione successiva

Vedere anche

DbgHelp Functions

SymInitialize

SymSetSearchPath