GlobalFree, fonction (winbase.h)

Article
08/27/2023

Libère l’objet mémoire globale spécifié et invalide son handle.

Note Les fonctions globales ont une surcharge plus importante et fournissent moins de fonctionnalités que d’autres fonctions de gestion de la mémoire. Les nouvelles applications doivent utiliser les fonctions de tas , sauf si la documentation indique qu’une fonction globale doit être utilisée. Pour plus d’informations, consultez Fonctions globales et locales.

Syntaxe

HGLOBAL GlobalFree(
  [in] _Frees_ptr_opt_ HGLOBAL hMem
);

Paramètres

[in] hMem

Handle de l’objet mémoire globale. Ce handle est retourné par la fonction GlobalAlloc ou GlobalReAlloc . Il n’est pas sûr de libérer de la mémoire allouée avec LocalAlloc.

Valeur retournée

Si la fonction réussit, la valeur de retour est NULL.

Si la fonction échoue, la valeur de retour est égale à un handle de l’objet de mémoire globale. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si le processus examine ou modifie la mémoire une fois qu’elle a été libérée, un tas endommagé peut se produire ou une exception de violation d’accès (EXCEPTION_ACCESS_VIOLATION) peut être générée.

La fonction GlobalFree libère un objet mémoire verrouillé. Un objet mémoire verrouillé a un nombre de verrous supérieur à zéro. La fonction GlobalLock verrouille un objet de mémoire globale et incrémente le nombre de verrous d’un. La fonction GlobalUnlock le déverrouille et décrémente le nombre de verrous d’un. Pour obtenir le nombre de verrous d’un objet mémoire globale, utilisez la fonction GlobalFlags .

Si une application s’exécute sous une version de débogage du système, GlobalFree émet un message vous indiquant qu’un objet verrouillé est en cours de libération. Si vous déboguez l’application, GlobalFree entrera dans un point d’arrêt juste avant de libérer un objet verrouillé. Cela vous permet de vérifier le comportement prévu, puis de poursuivre l’exécution.

Exemples

Pour obtenir un exemple, consultez GlobalAlloc.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll