Fonction LocalSize (winbase.h)

Article
03/03/2024

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