GlobalFlags, fonction (winbase.h)
Récupère des informations sur l’objet mémoire globale spécifié.
Syntaxe
UINT GlobalFlags(
[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 spécifie les valeurs d’allocation et le nombre de verrous pour l’objet mémoire.
Si la fonction échoue, la valeur de retour est GMEM_INVALID_HANDLE, ce qui indique que le handle global n’est pas valide. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
L’octet d’ordre inférieur du mot d’ordre inférieur de la valeur de retour contient le nombre de verrous de l’objet . Pour récupérer le nombre de verrous à partir de la valeur de retour, utilisez le masque de GMEM_LOCKCOUNT avec l’opérateur AND (&) au niveau du bit. Le nombre de verrous d’objets mémoire alloués avec GMEM_FIXED est toujours égal à zéro.
L’octet d’ordre élevé du mot d’ordre inférieur de la valeur de retour indique les valeurs d’allocation de l’objet mémoire. Il peut être égal à zéro ou GMEM_DISCARDED.
Les fonctions globales 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 globale doit être utilisée. Pour plus d’informations, consultez Fonctions globales et locales.
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 |