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 |