GlobalSize, fonction (winbase.h)

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

Note Les fonctions globales ont une surcharge plus importante et fournissent moins de fonctionnalités que les 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 globale doit être utilisée. Pour plus d’informations, consultez Fonctions globales et locales.

 

Syntaxe

SIZE_T GlobalSize(
  [in] HGLOBAL hMem
);

Paramètres

[in] hMem

Handle de l’objet mémoire globale. Ce handle est retourné par la fonction GlobalAlloc ou GlobalReAlloc .

Valeur retournée

Si la fonction réussit, la valeur de retour est la taille de l’objet mémoire globale 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é, utilisez la fonction GlobalFlags avant d’appeler GlobalSize.

Configuration requise

Condition requise	Valeur
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

GlobalAlloc

GlobalFlags

GlobalReAlloc

Fonctions de gestion de la mémoire