Funzione GetHGlobalFromILockBytes (coml2api.h)
La funzione GetHGlobalFromILockBytes recupera un handle di memoria globale in un oggetto matrice di byte creato usando la funzione CreateILockBytesOnHGlobal .
Sintassi
HRESULT GetHGlobalFromILockBytes(
[in] LPLOCKBYTES plkbyt,
[out] HGLOBAL *phglobal
);
Parametri
[in] plkbyt
Puntatore all'interfaccia ILockBytes nell'oggetto matrice di byte creato in precedenza da una chiamata alla funzione CreateILockBytesOnHGlobal .
[out] phglobal
Puntatore all'handle di memoria corrente utilizzato dall'oggetto matrice di byte specificato.
Valore restituito
Questa funzione restituisce HRESULT.
Commenti
Dopo una chiamata a CreateILockBytesOnHGlobal, che crea un oggetto matrice di byte nella memoria globale, GetHGlobalFromILockBytes recupera un puntatore all'handle della memoria globale sottostante l'oggetto matrice di byte. L'handle restituito da questa funzione potrebbe essere diverso dall'handle originale a causa di chiamate intermedie alla funzione GlobalReAlloc .
Il contenuto dell'handle di memoria restituito può essere scritto in un file disco pulito e quindi aperto come oggetto di archiviazione usando la funzione StgOpenStorage .
Questa funzione funziona solo all'interno dello stesso processo da cui è stata creata la matrice di byte.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | coml2api.h (include Ole2.h) |
| Libreria | Ole32.lib |
| DLL | Ole32.dll |