Función Heap32ListFirst (tlhelp32.h)

Artículo
03/05/2024

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