Función Heap32First (tlhelp32.h)

Artículo
08/26/2023

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