Función HeapUnlock (heapapi.h)

Artículo
02/07/2024

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