Función Heap32Next (tlhelp32.h)
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 |