Fonction LocalHandle (winbase.h)
Récupère le handle associé au pointeur spécifié vers un objet mémoire local.
Note 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.
Syntaxe
HLOCAL LocalHandle(
[in] LPCVOID pMem
);
Paramètres
[in] pMem
Pointeur vers le premier octet de l’objet mémoire local. Ce pointeur est retourné par la fonction LocalLock .
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle pour l’objet mémoire local spécifié.
Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Lorsque la fonction LocalAlloc alloue un objet mémoire local avec LMEM_MOVEABLE, elle retourne un handle à l’objet . La fonction LocalLock convertit ce handle en pointeur vers le bloc de mémoire de l’objet, et LocalHandle reconvertit le pointeur en handle.
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 |