Поделиться через


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

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

Синтаксис

BOOL IMAGEAPI SymCleanup(
  [in] HANDLE hProcess
);

Параметры

[in] hProcess

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

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

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

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

Комментарии

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

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

Примеры

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

Требования

Требование Значение
Целевая платформа Windows
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 5.1 или более поздней версии

См. также раздел

Функции DbgHelp

SymInitialize