Partager via


Fonction LocalSize (winbase.h)

Récupère la taille actuelle de l’objet de mémoire locale spécifié, en octets.

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

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

Paramètres

[in] hMem

Handle de l’objet de mémoire locale. Ce handle est retourné par la fonction LocalAlloc, LocalReAlloc ou LocalHandle .

Valeur retournée

Si la fonction réussit, la valeur de retour est la taille de l’objet de mémoire locale spécifié, en octets. Si le handle spécifié n’est pas valide ou si l’objet a été ignoré, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La taille d’un bloc de mémoire peut être supérieure à la taille demandée lorsque la mémoire a été allouée.

Pour vérifier que le bloc de mémoire de l’objet spécifié n’a pas été ignoré, appelez la fonction LocalFlags avant d’appeler LocalSize.

Configuration requise

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

Voir aussi

Fonctions globales et locales

LocalAlloc

LocalFlags

LocalHandle

LocalReAlloc

Fonctions de gestion de la mémoire