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

Статья
08/26/2023

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

Синтаксис

BOOL Heap32ListFirst(
  [in]      HANDLE       hSnapshot,
  [in, out] LPHEAPLIST32 lphl
);

Параметры

[in] hSnapshot

Дескриптор snapshot возвращен при предыдущем вызове функции CreateToolhelp32Snapshot.

[in, out] lphl

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

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

Возвращает значение TRUE , если первая запись списка кучи была скопирована в буфер или false в противном случае. Значение ошибки ERROR_NO_MORE_FILES возвращается функцией GetLastError, если список кучи не существует или snapshot не содержит сведения о списке кучи.

Вызывающее приложение должно задать члену dwSizeHEAPLIST32 размер структуры в байтах. Heap32ListFirst изменяет dwSize на количество байтов, записанных в структуру. Это значение никогда не будет больше начального значения dwSize, но может быть меньше. Если значение меньше, не следует полагаться на значения элементов, смещения которых больше этого значения.

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

Примеры

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

Требования

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