Função Heap32ListNext (tlhelp32.h)

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

Sintaxe

BOOL Heap32ListNext(
  [in]  HANDLE       hSnapshot,
  [out] LPHEAPLIST32 lphl
);

Parâmetros

[in] hSnapshot

Um identificador para o instantâneo retornado de uma chamada anterior para a função CreateToolhelp32Snapshot.

[out] lphl

Um ponteiro para uma estrutura HEAPLIST32 .

Retornar valor

Retornará TRUE se a próxima entrada da lista de heaps tiver sido copiada para o buffer ou FALSE caso contrário. O valor de erro ERROR_NO_MORE_FILES é retornado pela função GetLastError quando não existem mais entradas na lista de heaps.

Comentários

Para recuperar informações sobre o primeiro heap em uma lista de heaps, use a função Heap32ListFirst .

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