Fonction HeapUnlock (heapapi.h)

Article
02/07/2024

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

Énumération d’un tas

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