Funzione SymCleanup (dbghelp.h)

Dealloca tutte le risorse associate all'handle del 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 ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Questa funzione libera tutte le risorse associate all'handle del processo. L'errore 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 potrebbero causare un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, chiamare SymInitialize solo quando il processo viene avviato e SymCleanup solo al termine del processo. Non è necessario per ogni thread del processo chiamare queste funzioni.

Esempio

Per un esempio, vedere Terminazione del gestore simboli.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione dbghelp.h
Libreria Dbghelp.lib
DLL Dbghelp.dll
Componente ridistribuibile DbgHelp.dll 5.1 o versioni successive

Vedi anche

Funzioni DbgHelp

SymInitialize