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 |