Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Imposta il percorso di ricerca per il processo specificato.
Sintassi
BOOL IMAGEAPI SymSetSearchPathW(
[in] HANDLE hProcess,
[in, optional] PCWSTR 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 non riesce, il valore restituito viene FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Osservazioni
Il percorso di ricerca dei simboli può essere modificato un numero qualsiasi 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
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 SymSetSearchPath 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 |