Функция GetProcessHeaps позволяет получить дескрипторы всех куч, которые в настоящее время действительны для вызывающего процесса.
function GetProcessHeaps( NumberOfHeaps: DWORD; // максимальное количество дескрипторов куч var ProcessHeaps: THandle // первый элемент в буфере для дескрипторов куч ): DWORD; stdcall;
Параметры
NumberOfHeaps [in]
Показываем максимальное количество дескрипторов куч, которые можно сохранить в
буфере ProcessHeaps.
ProcessHeaps [out]
Указатель на первый элемент в массиве, с которого будет произведена запись
дескрипторов куч.
Возвращаемое значение
Возвращаемым значением функции является количество куч, которые в настоящее время действительны для вызывающего процесса.
Если полученное значение меньше либо равно значению NumberOfHeaps, то это число является количеством дескрипторов куч, которые были сохранены в массиве ProcessHeaps.
Если полученное значение больше значения NumberOfHeaps, то буфер, на который указывает ProcessHeaps слишком мал для того, чтобы вместить все дескрипторы куч, которые в настоящее время действительны для вызывающего процесса. Поэтому функция не произведет сохранение дескрипторов куч в данном буфере. В этом случае вы должны использовать возвращаемое значение для того, чтобы увеличить буфер до величины, достаточной чтобы поместить все дескрипторы куч, и попытаться выполнить вызов функции снова.
В случае возникновения ошбки функция возвращает 0, поскольку любой процесс имеет по крайней мере одну кучу (кучу процесса). Для получения расширенной информации об ошибке выполните вызов GetLastError.
Описание
Вы можете использовать вызов GetProcessHeaps для того, чтобы получить кучу вызывающего процесса. Первой в списке ProcessHeaps будет куча вызывающего процесса, а уже затем все кучи, которые были созданы при помощи вызова HeapCreate.
Требования
Windows NT/2000: Требуется Windows NT 3.5 или более поздняя версия
Windows 95/98: Не поддерживается
Бибиотека: Kernel32.dll
Подключаемый модуль: Windows
Смотри также:
| GetProcessHeap |
HeapAlloc |
© Mystic, 2002