Função Heap32ListFirst (tlhelp32.h)
Recupera informações sobre o primeiro heap que foi alocado por um processo especificado.
Sintaxe
BOOL Heap32ListFirst(
[in] HANDLE hSnapshot,
[in, out] LPHEAPLIST32 lphl
);
Parâmetros
[in] hSnapshot
Um identificador para o instantâneo retornado de uma chamada anterior para a função CreateToolhelp32Snapshot.
[in, out] lphl
Um ponteiro para uma estrutura HEAPLIST32 .
Retornar valor
Retornará TRUE se a primeira 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 existe nenhuma lista de heaps ou o instantâneo não contém informações de lista de heap.
Comentários
O aplicativo de chamada deve definir o membro dwSize de HEAPLIST32 para o tamanho, em bytes, da estrutura. Heap32ListFirst altera dwSize para o número de bytes gravados na estrutura. Isso nunca será maior que o valor inicial de dwSize, mas pode ser menor. Se o valor for menor, não dependa dos valores de nenhum membro cujos deslocamentos sejam maiores que esse valor.
Para recuperar informações sobre outros heaps na lista de heaps, use a função Heap32ListNext .
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 |