Функция Heap32Next (tlhelp32.h)

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

Синтаксис

BOOL Heap32Next(
  [out] LPHEAPENTRY32 lphe
);

Параметры

[out] lphe

Указатель на структуру HEAPENTRY32 .

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

Возвращает значение TRUE , если сведения о следующем блоке в куче были скопированы в буфер или false в противном случае. Функция GetLastError возвращает ERROR_NO_MORE_FILES , когда больше нет объектов в куче, и ERROR_INVALID_DATA , если куча повреждена или изменена во время прогулки таким образом, что Heap32Next не сможет продолжить работу.

Комментарии

Чтобы получить сведения для первого блока кучи, используйте функцию Heap32First .

Функция Heap32Next не поддерживает ссылку на целевой процесс. Если целевой процесс умирает, система может создать новый процесс, используя тот же идентификатор процесса. Таким образом, вызывающий объект должен сохранять ссылку на целевой процесс до тех пор, пока он использует Heap32Next.

Прогулка по куче с Heap32First и Heap32Next неэффективна , особенно для больших кучи. Вместо этого используйте HeapWalk .

Примеры

Пример см. в разделе Обход списка кучи.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	tlhelp32.h
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

HEAPENTRY32

Куча Списки и куча ходьбы

Heap32First

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