Partager via


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

É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

Voir aussi

Fonctions de tas

HeapLock

HeapWalk

Fonctions de gestion de la mémoire

API Vertdll disponibles dans les enclaves VBS