Compartilhar via


Função HeapDestroy (heapapi.h)

Destrói o objeto heap especificado.

HeapDestroy descompõe e libera todas as páginas de um objeto de heap privado e invalida o identificador para o heap.

Sintaxe

BOOL HeapDestroy(
  [in] HANDLE hHeap
);

Parâmetros

[in] hHeap

Um identificador para o heap a ser destruído. Esse identificador é retornado pela função HeapCreate . Não use o identificador para o heap de processo retornado pela função GetProcessHeap .

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Os processos podem chamar HeapDestroy sem primeiro chamar a função HeapFree para liberar memória alocada do heap.

Exemplos

Enumerando um heap

Requisitos

   
Cliente mínimo com suporte Windows XP [aplicativos da área de trabalho | aplicativos UWP]
Servidor mínimo com suporte Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho heapapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções heap

Heapcreate

Funções de gerenciamento da memória

APIs Vertdll disponíveis em enclaves de VBS