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 Professional [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | coml2api.h (Ole2.h を含む) |
| Library | Ole32.lib |
| [DLL] | Ole32.dll |