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

Извлекает дескриптор в кучу по умолчанию вызывающего процесса. Затем этот дескриптор можно использовать в последующих вызовах функций кучи.

Синтаксис

HANDLE GetProcessHeap();

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

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

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

Комментарии

Функция GetProcessHeap получает дескриптор к куче по умолчанию для вызывающего процесса. Процесс может использовать этот дескриптор для выделения памяти из кучи процесса без предварительного создания частной кучи с помощью функции HeapCreate .

Windows Server 2003 и Windows XP: Чтобы включить кучи с низким уровнем фрагментации для кучи по умолчанию процесса, вызовите функцию HeapSetInformation с дескриптором, возвращенным GetProcessHeap.

Примеры

Пример см. в разделе Получение кучи процессов.

Требования

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

См. также

Функции кучи

HeapCreate

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

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