Funzione SymSetSearchPath (dbghelp.h)

Imposta il percorso di ricerca per il processo specificato.

Sintassi

BOOL IMAGEAPI SymSetSearchPath(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SearchPath
);

Parametri

[in] hProcess

Handle per il processo passato originariamente alla funzione SymInitialize .

[in, optional] SearchPath

Percorso di ricerca dei simboli. La stringa può contenere più percorsi separati da punti e virgola.

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

Il percorso di ricerca dei simboli può essere modificato qualsiasi numero di volte mentre la libreria è in uso da un'applicazione. La modifica influisce su tutte le chiamate future al gestore dei simboli.

Per ottenere il percorso di ricerca corrente, chiamare la funzione SymGetSearchPath .

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

SymGetSearchPath

SymInitialize