Langage de programmation - C pour Windows - API de Windows

LocalFree	kernel32.dll	Libère local
Windows 9X, NT 3.1+, 2000, XP, 2003

HLOCAL LocalFree(HLOCAL hMem);

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

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 locale. Pour obtenir des informations d'erreur étendues, appelez la fonction GetLastError.

Cette fonction permet de demander l'objet de mémoire local et d'invalider un Handle.

Si le processus tente d'examiner ou de modifier la mémoire après sa libération, il peut en résulter une corruption de segment ou une exception de violation d'accès (EXCEPTION_ACCESS_VIOLATION) peut être générée.
Si le paramètre hMem est NULL, LocalFree ignore le paramètre et renvoie NULL.
La fonction LocalFree réussit même si l'objet mémoire est verrouillé par un appel précédent à la fonction LocalLock. La fonction LocalLock verrouille un objet de la mémoire locale et incrémente le nombre de verrous de un. La fonction LocalUnlock le déverrouille et diminue le nombre de verrous de un. Pour obtenir le nombre de verrous d'un objet de mémoire locale, utilisez la fonction LocalFlags. La fonction LocalFree libérera un objet de mémoire verrouillé. Un objet mémoire verrouillé a un nombre de verrous supérieur à zéro.
Les fonctions GlobalFree et LocalFree libéreront tous deux un objet mémoire verrouillé. Toutefois, si vous exécutez une application sous une version de débogage de Windows NT ou Windows 95, les fonctions GlobalFree et LocalFree enverront un message vous indiquant que cela se produit. Si vous déboguez l'application, les fonctions GlobalFree et LocalFree entreront un point d'arrêt codé en dur juste avant de libérer un objet verrouillé. Cette situation vous permet de vérifier le comportement souhaité.

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

Section courante