Função SymCleanup (dbghelp.h)
Desaloca todos os recursos associados ao identificador do processo.
Sintaxe
BOOL IMAGEAPI SymCleanup(
[in] HANDLE hProcess
);
Parâmetros
[in] hProcess
Um identificador para o processo que foi originalmente passado para a função SymInitialize .
Retornar valor
Se a função for bem-sucedida, o valor retornado será TRUE.
Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.
Comentários
Essa função libera todos os recursos associados ao identificador do processo. Falha ao chamar essa função causa perda de memória e recursos no aplicativo de chamada
Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, chame SymInitialize somente quando o processo for iniciado e symCleanup somente quando o processo terminar. Não é necessário que cada thread no processo chame essas funções.
Exemplos
Para obter um exemplo, consulte Terminando o manipulador de símbolos.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Windows |
| Cabeçalho | dbghelp.h |
| Biblioteca | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Redistribuível | DbgHelp.dll 5.1 ou posterior |