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

Vedi anche

CreateILockBytesOnHGlobal

StgOpenStorage