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 passado originalmente para a função SymInitialize.
Valor de retorno
Se a função for bem-sucedida, o valor retornado será VERDADEIRO.
Se a função falhar, o valor retornado será false. Para recuperar informações de erro estendidas, chame GetLastError.
Observações
Essa função libera todos os recursos associados ao identificador do processo. A falha ao chamar essa função causa perda de memória e de recursos no aplicativo de chamada.
Todas as funções DbgHelp, como esta, são threaded simples. 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 |
|---|---|
| da Plataforma de Destino | Windows |
| cabeçalho | dbghelp.h |
| biblioteca | Dbghelp.lib |
| de DLL | Dbghelp.dll |
| redistribuível | DbgHelp.dll 5.1 ou posterior |