IDataObject_GetDataHere

データコンシューマーがソースデータオブジェクトからデータを取得するために呼び出す。このメソッドは、呼び出し側が指定した記憶メディウムの確保と解放を行わなければならない点で GetData メソッドと異なる。

IDataObject_GetDataHere this, pformatetc, pmedium

this : [comobj] IDataObject インターフェースの COM オブジェクト変数
pformatetc : [var] データを渡す際に使用する形式、メディウム、ターゲットデバイスを定義する FORMATETC 構造体へのポインター。tymed には 1 つのメディウムしか指定できず、TYMED_ISTORAGE、TYMED_ISTREAM、TYMED_HGLOBAL、TYMED_FILE のみが有効である。
pmedium : [int] 転送されるデータを含む記憶メディウムを定義する STGMEDIUM 構造体へのポインター。メディウムは呼び出し側が確保し、GetDataHere が埋める。呼び出し側はメディウムの解放も行う必要がある。このメソッドの実装は、このパラメーターが指す STGMEDIUM 構造体の punkForRelease メンバーに常に NULL を設定しなければならない。

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

解説

データコンシューマーがソースデータオブジェクトからデータを取得するために呼び出す。このメソッドは、呼び出し側が指定した記憶メディウムの確保と解放を行わなければならない点で
GetData メソッドと異なる。

[戻り値]
成功時は S_OK を返す。その他の値には以下のものが含まれる。
（以下省略）

[備考]
GetDataHere メソッドは IDataObject::GetData と似ているが、pmedium
で指定されるメディウムの確保と解放を呼び出し側が行う必要がある点が異なる。GetDataHere は FORMATETC
構造体で記述されたデータをレンダリングし、呼び出し側が提供する STGMEDIUM 構造体にデータをコピーする。例えばメディウムが
TYMED_HGLOBAL の場合、このメソッドはメディウムのサイズを変更したり新しい hGlobal
を確保したりできない。メタファイルなどの GDI 型などは GetDataHere
での使用に適さないメディウムもある。GetDataHere
メソッドは呼び出し側が提供するメタファイルにデータを格納できない。一般に、このメソッドでサポートすべき記憶メディウムは
TYMED_ISTORAGE、TYMED_ISTREAM、TYMED_FILE のみである。転送メディウムがストリームである場合、OLE
はデータが返される場所とストリームのシークポインターの位置について仮定する。GetData
の呼び出しでは、返されるデータはストリームの位置 0
からストリームの現在のシークポインター（終了時の位置）直前までである。GetDataHere
の場合、返されるデータは呼び出し時のストリームの位置から終了時の位置の直前までである。

情報