Partager via


Fonction LocalFree (winbase.h)

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

Note Les fonctions locales 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 locale doit être utilisée. Pour plus d’informations, consultez Fonctions globales et locales.
 

Syntaxe

HLOCAL LocalFree(
  [in] _Frees_ptr_opt_ HLOCAL hMem
);

Paramètres

[in] hMem

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

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 locale. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si le processus tente d’examiner ou de modifier la mémoire une fois qu’elle a été libérée, une altération du tas peut se produire ou une exception de violation d’accès (EXCEPTION_ACCESS_VIOLATION) peut être générée.

Si le paramètre hMem a la valeur NULL, LocalFree ignore le paramètre et retourne NULL.

La fonction LocalFree libère un objet mémoire verrouillé. Un objet de mémoire verrouillé a un nombre de verrous supérieur à zéro. La fonction LocalLock verrouille un objet de mémoire locale et incrémente le nombre de verrous d’un. La fonction LocalUnlock le déverrouille et décrémente le nombre de verrous d’un. Pour obtenir le nombre de verrous d’un objet de mémoire locale, utilisez la fonction LocalFlags .

Si une application s’exécute sous une version de débogage du système, LocalFree émet un message indiquant qu’un objet verrouillé est libéré. Si vous déboguez l’application, LocalFree entrera 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 LocalAlloc.

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

Voir aussi

Fonctions globales et locales

GlobalFree

LocalAlloc

LocalFlags

LocalLock

LocalReAlloc

LocalUnlock

Fonctions de gestion de la mémoire