Función Heap32First (tlhelp32.h)
Recupera información sobre el primer bloque de un montón asignado por un proceso.
Sintaxis
BOOL Heap32First(
[in, out] LPHEAPENTRY32 lphe,
[in] DWORD th32ProcessID,
[in] ULONG_PTR th32HeapID
);
Parámetros
[in, out] lphe
Puntero a una estructura de HEAPENTRY32 .
[in] th32ProcessID
Identificador del contexto de proceso que posee el montón.
[in] th32HeapID
Identificador del montón que se va a enumerar.
Valor devuelto
Devuelve TRUE si la información del primer bloque de montón se ha copiado en el búfer o FALSE en caso contrario. La función GetLastError devuelve el valor de error ERROR_NO_MORE_FILES si el montón no es válido o está vacío.
Comentarios
La aplicación que llama debe establecer el miembro dwSize de HEAPENTRY32 en el tamaño, en bytes, de la estructura. Heap32First 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 acceder a los bloques posteriores del mismo montón, use la función Heap32Next .
Caminar el montón con Heap32First 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
| 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 |