Fonction LocalFree (winbase.h)

Article
08/27/2023

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