Funzione SymCleanup (dbghelp.h)
Dealloca tutte le risorse associate all'handle di processo.
Sintassi
BOOL IMAGEAPI SymCleanup(
[in] HANDLE hProcess
);
Parametri
[in] hProcess
Handle per il processo passato originariamente alla funzione SymInitialize.
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
Questa funzione libera tutte le risorse associate all'handle di processo. L'impossibilità di chiamare questa funzione causa perdite di memoria e risorse nell'applicazione chiamante.
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, chiama SymInitialize solo all'avvio del processo e SymCleanup solo al termine del processo. Non è necessario che ogni thread nel processo chiami queste funzioni.
Esempi
Per un esempio, vedere terminazione del gestore dei simboli.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione | dbghelp.h |
| libreria | Dbghelp.lib |
| dll | Dbghelp.dll |
| Ridistribuibile | DbgHelp.dll 5.1 o versione successiva |