Fonction LocalFlags (winbase.h)
Récupère des informations sur l’objet mémoire local spécifié.
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 |