GetProcessHeap

Функция GetProcessHeap возвращает дескриптор кучи вызывающего процесса. Полученный дескриптор может впоследствии использоваться при вызовах HeapAlloc, HeapReAlloc, HeapFree и HeapSize.

function GetProcessHeap: THandle; stdcall;

Параметры

Функция не имеет параметров.

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

В случае удачного завершения возвращаемым значением функции является дескриптор кучи вызывающего процесса.

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

Описание

Функция GetProcessHeap позволяет вам производить выделения памяти из кучи процесса без ее предварительного создания при помощи функции HeapCreate, как это показано с следующем примере:
HeapAlloc(GetProcessHeap, 0, dwBytes);

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

Для того, чтобы уберечь себя от ошибки нарушения доступа (access violation), вы должны защитить блоками структурной обработки исключений любой код, выполняющий операции чтения/записи в кучу. Для большей информации по этому вопросу смотрите раздел "Структурная обработка исключений".

Требования

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

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

Список функций

GetProcessHeaps

© Mystic, 2002