Função Heap32Next (tlhelp32.h)

Artigo
03/13/2024

Recupera informações sobre o próximo bloco de um heap que foi alocado por um processo.

Sintaxe

BOOL Heap32Next(
  [out] LPHEAPENTRY32 lphe
);

Parâmetros

[out] lphe

Um ponteiro para uma estrutura HEAPENTRY32 .

Retornar valor

Retornará TRUE se as informações sobre o próximo bloco no heap tiverem sido copiadas para o buffer ou FALSE caso contrário. A função GetLastError retorna ERROR_NO_MORE_FILES quando não houver mais objetos no heap e ERROR_INVALID_DATA se o heap parecer estar corrompido ou for modificado durante a caminhada de forma que Heap32Next não possa continuar.

Comentários

Para recuperar informações para o primeiro bloco de um heap, use a função Heap32First .

A função Heap32Next não mantém uma referência ao processo de destino. Se o processo de destino falhar, o sistema poderá criar um novo processo usando o mesmo identificador de processo. Portanto, o chamador deve manter uma referência ao processo de destino, desde que esteja usando Heap32Next.

Andar no heap com Heap32First e Heap32Next é ineficiente, especialmente para heaps grandes. Em vez disso, use HeapWalk .

Exemplos

Para obter um exemplo, consulte Atravessando a lista de heaps.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	tlhelp32.h
Biblioteca	Kernel32.lib
DLL	Kernel32.dll