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


Функция HeapDestroy (heapapi.h)

Уничтожает указанный объект кучи.

HeapDeистрой отменяет фиксацию и освобождает все страницы частного объекта кучи и делает дескриптор кучи недействительным.

Синтаксис

BOOL HeapDestroy(
  [in] HANDLE hHeap
);

Параметры

[in] hHeap

Дескриптор кучи, который необходимо уничтожить. Этот дескриптор возвращается функцией HeapCreate . Не используйте дескриптор для кучи процесса, возвращаемой функцией GetProcessHeap .

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

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

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

Комментарии

Процессы могут вызывать HeapDeмеши без предварительного вызова функции HeapFree для освобождения памяти, выделенной из кучи.

Примеры

Перечисление кучи

Требования

   
Минимальная версия клиента Windows XP [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2003 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header heapapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

Функции кучи

HeapCreate

Функции управления памятью

API-интерфейсы Vertdll, доступные в анклавах VBS