Partager via


Fonction LocalFlags (winbase.h)

Récupère des informations sur l’objet mémoire local 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 LocalFlags(
  [in] HLOCAL hMem
);

Paramètres

[in] hMem

Handle de l’objet mémoire local. Ce handle est retourné par la fonction LocalAlloc ou LocalReAlloc .

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 LMEM_INVALID_HANDLE, ce qui indique que le handle local 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 renvoyée, utilisez le masque de LMEM_LOCKCOUNT avec l’opérateur and (&) au niveau du bit. Le nombre de verrous d’objets mémoire alloués avec LMEM_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 LMEM_DISCARDABLE.

Les fonctions locales ont une plus grande surcharge 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.

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

GlobalFlags

LocalAlloc

LocalDiscard

LocalLock

LocalReAlloc

LocalUnlock

Fonctions de gestion de la mémoire