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

Voir aussi

CreateILockBytesOnHGlobal

StgOpenStorage