Fonction GlobalHandle (winbase.h)

Article
27/08/2023

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

C++

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