GetHGlobalFromILockBytes

GetHGlobalFromILockBytes 関数は、CreateILockBytesOnHGlobal 関数を使用して作成されたバイト配列オブジェクトに対するグローバルメモリハンドルを取得する。

GetHGlobalFromILockBytes plkbyt, phglobal

plkbyt : [var] 以前に CreateILockBytesOnHGlobal 関数の呼び出しによって作成されたバイト配列オブジェクト上の ILockBytes インターフェイスへのポインタ。
phglobal : [var] 指定されたバイト配列オブジェクトが使用している現在のメモリハンドルへのポインタ。

(プラグイン / モジュール : ole32.dll)

解説

GetHGlobalFromILockBytes 関数は、CreateILockBytesOnHGlobal
関数を使用して作成されたバイト配列オブジェクトに対するグローバルメモリハンドルを取得する。

[戻り値]
この関数は HRESULT を返す。

[備考]
グローバルメモリ上にバイト配列オブジェクトを作成する CreateILockBytesOnHGlobal
の呼び出し後、GetHGlobalFromILockBytes
はバイト配列オブジェクトの基となるグローバルメモリのハンドルへのポインタを取得する。この関数が返すハンドルは、途中の
GlobalReAlloc
関数の呼び出しにより、元のハンドルと異なる場合がある。返されたメモリハンドルの内容は、クリーンなディスクファイルに書き込んで、StgOpenStorage
関数を使ってストレージオブジェクトとして開くことができる。この関数は、バイト配列を作成したプロセスと同じプロセス内でのみ動作する。

情報

プラグイン / モジュールole32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の ole32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_ole32_gen2.hs