HeapDestroy

Функция HeapDestroy разрушает указанную кучу. Функция HeapDestroy освобождает всю память, что находилась в ведении кучи, делая все указатели, которые были получены при работе с кучей, неравильными.

function HeapDestroy(
  hHeap: THandle    // дескриптор кучи
): BOOL; stdcall;

Параметры

hHeap [in]
Дескриптор кучи, которая будет разрушена. Этот указатель должен быть дескриптором, полученным при вызове функции HeapCreate. Никогда не передавайте этой функции дескриптор, полученный при вызове GetProcessHeap.

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

В случае удачного заверения функция возвращает True.

В случае ошибки функция вернет False. Для получения расширенной информации об ошибке следует сделать вызов GetLastError.

Описание

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

Требования

Windows NT/2000: Требуется Windows NT 3.1 или более поздняя версия
Windows 95/98: Требуется Windows 95 или более поздняя версия
Бибиотека: Kernel32.dll
Подключаемый модуль: Windows

Смотри также:

HeapCreate

HeapFree

© Mystic, 2002