Função SymCleanup (dbghelp.h)

  • Artigo

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

Confira também

Funções DbgHelp

SymInitialize