Função GetProcessHeap (heapapi.h)

Recupera um identificador para o heap padrão do processo de chamada. Esse identificador pode ser usado em chamadas subsequentes para as funções de heap.

Sintaxe

HANDLE GetProcessHeap();

Retornar valor

Se a função for bem-sucedida, o valor retornado será um identificador para o heap do processo de chamada.

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

Comentários

A função GetProcessHeap obtém um identificador para o heap padrão para o processo de chamada. Um processo pode usar esse identificador para alocar memória do heap de processo sem precisar primeiro criar um heap privado usando a função HeapCreate .

Windows Server 2003 e Windows XP: Para habilitar o heap de baixa fragmentação para o heap padrão do processo, chame a função HeapSetInformation com o identificador retornado por GetProcessHeap.

Exemplos

Para obter um exemplo, consulte Obtendo heaps de processo.

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