Função Heap32Next (tlhelp32.h)
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 |