Función Heap32ListFirst (tlhelp32.h)
Recupera información sobre el primer montón asignado por un proceso especificado.
Sintaxis
BOOL Heap32ListFirst(
[in] HANDLE hSnapshot,
[in, out] LPHEAPLIST32 lphl
);
Parámetros
[in] hSnapshot
Identificador de la instantánea devuelta desde una llamada anterior a la función CreateToolhelp32Snapshot .
[in, out] lphl
Puntero a una estructura de HEAPLIST32 .
Valor devuelto
Devuelve TRUE si la primera entrada de la lista de montón se ha copiado en el búfer o FALSE de lo contrario. La función GetLastError devuelve el valor de error ERROR_NO_MORE_FILES cuando no existe ninguna lista de montón o la instantánea no contiene información de lista de montón.
Comentarios
La aplicación que llama debe establecer el miembro dwSize de HEAPLIST32 en el tamaño, en bytes, de la estructura. Heap32ListFirst cambia dwSize al número de bytes escritos en la estructura. Esto nunca será mayor que el valor inicial de dwSize, pero puede ser menor. Si el valor es menor, no confíe en los valores de ningún miembro cuyos desplazamientos sean mayores que este valor.
Para recuperar información sobre otros montones de la lista de montón, use la función Heap32ListNext .
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 |