Langage de programmation - C pour Windows - API de Windows

GlobalFree	kernel32.dll	Libération globale

HGLOBAL GlobalFree(HGLOBAL hMem);

Nom	Description
hMem	Ce paramètre permet d'indiquer l'identificateur l'objet de mémoire globale. Ce descripteur est renvoyé par la fonction GlobalAlloc ou GlobalReAlloc.

Valeur	Description
NULL	Cette valeur permet d'indiquer que la fonction a réussis.
NULL !=	Ces valeurs permettent d'indiquer que la fonction a échoué et les valeurs de retour sont égale au descripteur de l'objet de mémoire globale. Pour obtenir des informations d'erreur étendues, appelez la fonction GetLastError.

Cette fonction permet de libérer de la mémoire dans les ressources global du système d'exploitation.

Une corruption de segment ou une exception de violation d'accès (EXCEPTION_ACCESS_VIOLATION) peut se produire si le processus tente d'examiner ou de modifier la mémoire après sa libération.
Si le paramètre hMem est NULL, la fonction GlobalFree échoue et le système génère une exception de violation d'accès.
Les fonctions GlobalFree et LocalFree libéreront tous deux un objet mémoire verrouillé. Un objet mémoire verrouillé a un nombre de verrous supérieur à 0. La fonction GlobalLock verrouille un objet de mémoire globale et incrémente le nombre de verrous de un. La fonction GlobalUnlock le déverrouille et diminue le nombre de verrous de un. Pour obtenir le nombre de verrous d'un objet de mémoire globale, utilisez la fonction GlobalFlags.
Windows NT : Toutefois, si une application s'exécute sous une version de débogage (DBG) de Windows NT, telle que celle distribuée sur le CD-ROM du SDK, les fonctions GlobalFree et LocalFree entrent un point d'arrêt juste avant de libérer un objet verrouillé. Cettte situation permet au programmeur de vérifier le comportement souhaité. Taper G en utilisant le débogueur dans cette situation permet à l'opération de libération de se produire.

Dernière mise à jour : Dimanche, le 6 décembre 2015

Section courante