Funzione HeapUnlock (heapapi.h)
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
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 |