Partager via


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

Voir aussi

Fonctions globales et locales

GlobalAlloc

GlobalLock

Fonctions de gestion de la mémoire