Función Heap32Next (tlhelp32.h)

Artículo
03/05/2024

Recupera información sobre el siguiente bloque de un montón asignado por un proceso.

Sintaxis

BOOL Heap32Next(
  [out] LPHEAPENTRY32 lphe
);

Parámetros

[out] lphe

Puntero a una estructura de HEAPENTRY32 .

Valor devuelto

Devuelve TRUE si se ha copiado información sobre el siguiente bloque del montón en el búfer o FALSE de lo contrario. La función GetLastError devuelve ERROR_NO_MORE_FILES cuando no existen más objetos del montón y ERROR_INVALID_DATA si el montón parece estar dañado o se modifica durante el recorrido de tal manera que Heap32Next no pueda continuar.

Comentarios

Para recuperar información del primer bloque de un montón, use la función Heap32First .

La función Heap32Next no mantiene una referencia al proceso de destino. Si el proceso de destino muere, el sistema puede crear un nuevo proceso con el mismo identificador de proceso. Por lo tanto, el autor de la llamada debe mantener una referencia al proceso de destino siempre que use Heap32Next.

Caminar el montón con Montón32First y Heap32Next es ineficaz, especialmente para montones grandes. Use HeapWalk en su lugar.

Ejemplos

Para obtener un ejemplo, vea Recorrer la lista de montón.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tlhelp32.h
Library	Kernel32.lib
Archivo DLL	Kernel32.dll