Funzione HeapUnlock (heapapi.h)

Articolo
02/07/2024

Rilascia la proprietà dell'oggetto sezione critica o del blocco associato a un heap specificato. Inverte l'azione della funzione HeapLock .

Sintassi

BOOL HeapUnlock(
  [in] HANDLE hHeap
);

Parametri

[in] hHeap

Handle per l'heap da sbloccare. Questo handle viene restituito dalla funzione HeapCreate o GetProcessHeap .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione HeapLock è principalmente utile per impedire l'allocazione e il rilascio della memoria heap da altri thread mentre il thread chiamante usa la funzione HeapWalk . La funzione HeapUnlock è l'inverso di HeapLock.

Ogni chiamata a HeapLock deve corrispondere a una chiamata corrispondente alla funzione HeapUnlock . Se non si chiama HeapUnlock , l'esecuzione di qualsiasi altro thread del processo chiamante che tenta di accedere all'heap verrà bloccata.

Se la funzione HeapUnlock viene chiamata in un heap creato con il flag HEAP_NO_SERIALIZATION , i risultati non sono definiti.

Esempio

Enumerazione di un heap

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	heapapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll