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

Voir aussi

Fonctions globales et locales

LocalAlloc

LocalLock

Fonctions de gestion de la mémoire