GetHGlobalFromILockBytes 函式 (coml2api.h)
GetHGlobalFromILockBytes 函式會擷取使用 CreateILockBytesOnHGlobal 函式建立之位元組陣組物件的全域記憶體句柄。
語法
HRESULT GetHGlobalFromILockBytes(
[in] LPLOCKBYTES plkbyt,
[out] HGLOBAL *phglobal
);
參數
[in] plkbyt
先前由呼叫 CreateILockBytesOnHGlobal 函式所建立之位元組陣組物件上的 ILockBytes 介面指標。
[out] phglobal
指定位元組數位物件所使用的目前記憶體句柄指標。
傳回值
此函式會傳回 HRESULT。
備註
呼叫 CreateILockBytesOnHGlobal 之後，它會在全域記憶體上建立位元組數位物件， GetHGlobalFromILockBytes 會擷取位元組數組對象基礎之全域記憶體句柄的指標。 此函式傳回的句柄可能與原始句柄不同，因為對 GlobalReAlloc 函式的交錯呼叫。
傳回的記憶體句柄內容可以寫入清除磁碟檔案，然後使用 StgOpenStorage 函式開啟為記憶體物件。
此函式只能在建立位元組數位的相同進程中運作。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | coml2api.h (包含 Ole2.h) |
| 程式庫 | Ole32.lib |
| Dll | Ole32.dll |