Fonction GlobalHandle (winbase.h)
Récupère le handle associé au pointeur spécifié vers un bloc de mémoire global.
Note Les fonctions globales ont une surcharge plus importante et fournissent moins de fonctionnalités que les 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.
Syntaxe
HGLOBAL GlobalHandle(
[in] LPCVOID pMem
);
Paramètres
[in] pMem
Pointeur vers le premier octet du bloc de mémoire global. Ce pointeur est retourné par la fonction GlobalLock .
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle de l’objet mémoire globale 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 GlobalAlloc alloue un objet mémoire avec GMEM_MOVEABLE, elle retourne un handle à l’objet. La fonction GlobalLock convertit ce handle en pointeur vers le bloc de mémoire, et GlobalHandle convertit 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 |