Функция SymCleanup (dbghelp.h)

Освобождает все ресурсы, связанные с дескриптором процесса.

Синтаксис

BOOL IMAGEAPI SymCleanup(
  [in] HANDLE hProcess
);

Параметры

[in] hProcess

Дескриптор процесса, который был первоначально передан в функцию SymInitialize.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение TRUE.

Если функция завершается ошибкой, возвращаемое значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Эта функция освобождает все ресурсы, связанные с дескриптором процесса. Сбой вызова этой функции приводит к утечкам памяти и ресурсов в вызывающем приложении.

Все функции DbgHelp, такие как этот, являются одним потоком. Таким образом, вызовы из нескольких потоков в эту функцию, скорее всего, приведет к непредвиденному поведению или повреждению памяти. Чтобы избежать этого, вызовите SymInitialize только при запуске процесса и SymCleanup только после завершения процесса. Для каждого потока в процессе вызова этих функций не требуется.

Примеры

Пример см. в разделе завершениеобработчика символов.

Требования

См. также

функций DbgHelp

SymInitialize