GetHGlobalFromILockBytes, fonction (coml2api.h)

La fonction GetHGlobalFromILockBytes récupère un handle de mémoire globale sur un objet de tableau d’octets créé à l’aide de la fonction CreateILockBytesOnHGlobal .

Syntaxe

HRESULT GetHGlobalFromILockBytes(
  [in]  LPLOCKBYTES plkbyt,
  [out] HGLOBAL     *phglobal
);

Paramètres

[in] plkbyt

Pointeur vers l’interface ILockBytes sur l’objet de tableau d’octets précédemment créé par un appel à la fonction CreateILockBytesOnHGlobal .

[out] phglobal

Pointeur vers le handle de mémoire actuel utilisé par l’objet de tableau d’octets spécifié.

Valeur retournée

Cette fonction retourne HRESULT.

Remarques

Après un appel à CreateILockBytesOnHGlobal, qui crée un objet de tableau d’octets sur la mémoire globale, GetHGlobalFromILockBytes récupère un pointeur vers le handle de la mémoire globale sous-jacente à l’objet tableau d’octets. Le handle que cette fonction retourne peut être différent du handle d’origine en raison d’appels intermédiaires à la fonction GlobalReAlloc .

Le contenu du handle de mémoire retourné peut être écrit dans un fichier disque propre, puis ouvert en tant qu’objet de stockage à l’aide de la fonction StgOpenStorage.

Cette fonction fonctionne uniquement dans le cadre du même processus à partir duquel le tableau d’octets a été créé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	coml2api.h (inclure Ole2.h)
Bibliothèque	Ole32.lib
DLL	Ole32.dll

Voir aussi

CreateILockBytesOnHGlobal

StgOpenStorage