Compartilhar via


Função HeapUnlock (heapapi.h)

Libera a propriedade do objeto de seção crítica, ou bloqueio, que está associado a um heap especificado. Ele inverte a ação da função HeapLock .

Sintaxe

BOOL HeapUnlock(
  [in] HANDLE hHeap
);

Parâmetros

[in] hHeap

Um identificador para o heap a ser desbloqueado. Esse identificador é retornado pela função HeapCreate ou 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

A função HeapLock é útil principalmente para impedir a alocação e a liberação de memória de heap por outros threads, enquanto o thread de chamada usa a função HeapWalk . A função HeapUnlock é o inverso do HeapLock.

Cada chamada para HeapLock deve ser correspondida por uma chamada correspondente à função HeapUnlock . A falha ao chamar HeapUnlock bloqueará a execução de quaisquer outros threads do processo de chamada que tentam acessar o heap.

Se a função HeapUnlock for chamada em um heap criado com o sinalizador HEAP_NO_SERIALIZATION , os resultados serão indefinidos.

Exemplos

Enumerando um heap

Requisitos

   
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 heapapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções heap

HeapLock

HeapWalk

Funções de gerenciamento da memória

APIs Vertdll disponíveis em enclaves de VBS