Fonction LocalFlags (winbase.h)

Article
08/27/2023

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