GlobalFlags, fonction (winbase.h)

  • Article

Récupère des informations sur l’objet mémoire globale spécifié.

Note Cette fonction est fournie uniquement pour la compatibilité avec les versions 16 bits de Windows. Les nouvelles applications doivent utiliser les fonctions de tas. Pour plus d'informations, consultez la section Notes.
 

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

Voir aussi

Fonctions globales et locales

GlobalAlloc

GlobalDiscard

GlobalReAlloc

Fonctions de gestion de la mémoire