Fonction HeapUnlock (heapapi.h)
Libère la propriété de l’objet de section critique, ou verrou, associé à un tas spécifié. Il inverse l’action de la fonction HeapLock .
Syntaxe
BOOL HeapUnlock(
[in] HANDLE hHeap
);
Paramètres
[in] hHeap
Poignée du tas à déverrouiller. Ce handle est retourné par la fonction HeapCreate ou GetProcessHeap .
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
La fonction HeapLock est principalement utile pour empêcher l’allocation et la libération de mémoire du tas par d’autres threads, tandis que le thread appelant utilise la fonction HeapWalk . La fonction HeapUnlock est l’inverse de HeapLock.
Chaque appel à HeapLock doit être mis en correspondance par un appel correspondant à la fonction HeapUnlock . L’échec de l’appel de HeapUnlock bloque l’exécution de tous les autres threads du processus appelant qui tentent d’accéder au tas.
Si la fonction HeapUnlock est appelée sur un tas créé avec l’indicateur HEAP_NO_SERIALIZATION , les résultats ne sont pas définis.
Exemples
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | heapapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |