Función HeapUnlock (heapapi.h)

Libera la propiedad del objeto de sección crítico, o bloqueo, asociado a un montón especificado. Invierte la acción de la función HeapLock .

Sintaxis

BOOL HeapUnlock(
  [in] HANDLE hHeap
);

Parámetros

[in] hHeap

Identificador del montón que se va a desbloquear. Este identificador lo devuelve la función HeapCreate o GetProcessHeap .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

La función HeapLock es principalmente útil para evitar la asignación y liberación de la memoria del montón por otros subprocesos, mientras que el subproceso que realiza la llamada usa la función HeapWalk . La función HeapUnlock es la inversa de HeapLock.

Cada llamada a HeapLock debe coincidir con una llamada correspondiente a la función HeapUnlock . Si no se llama a HeapUnlock , se bloqueará la ejecución de cualquier otro subproceso del proceso de llamada que intente acceder al montón.

Si se llama a la función HeapUnlock en un montón creado con la marca HEAP_NO_SERIALIZATION , los resultados no están definidos.

Ejemplos

Enumerar un montón

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado heapapi.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones del montón

HeapLock

HeapWalk

Funciones de administración de memoria

API de Vertdll disponibles en enclaves de VBS