IDataObject_SetData

データソースを含むオブジェクトから呼び出され、このメソッドを実装するオブジェクトにデータを転送する。

IDataObject_SetData this, pformatetc, pmedium, fRelease

this : [comobj] IDataObject インターフェースの COM オブジェクト変数
pformatetc : [var] 記憶メディウムに含まれるデータをデータオブジェクトが解釈する際の形式を定義する FORMATETC 構造体へのポインター。
pmedium : [int] データが渡される記憶メディウムを定義する STGMEDIUM 構造体へのポインター。
fRelease : [int] TRUE の場合、SetData を実装するデータオブジェクトは呼び出し戻り後に記憶メディウムの所有権を持つ。つまり使用後に ReleaseStgMedium 関数を呼び出してメディウムを解放しなければならない。FALSE の場合、呼び出し側は記憶メディウムの所有権を保持し、呼び出されたデータオブジェクトはこの呼び出しの間だけメディウムを使用する。

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

解説

データソースを含むオブジェクトから呼び出され、このメソッドを実装するオブジェクトにデータを転送する。

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

[備考]
SetData
は別のオブジェクトが、実装側のデータオブジェクトにデータを送信しようと試みることを可能にする。別のオブジェクトからデータを受け取るサポートがあるデータオブジェクトはこのメソッドを実装する。サポートしない場合は
E_NOTIMPL を返すように実装すべきである。呼び出し側は pmedium
パラメーターで示される記憶メディウムを確保し、そこにデータが渡される。呼び出されたデータオブジェクトは、データを正常に受け取ってエラーコードを返さない限りデータの所有権を取得しない。fRelease
パラメーターの値は呼び出し戻り後のメディウムの所有権を示す。FALSE
は呼び出し側が依然としてメディウムを所有することを示し、データオブジェクトは呼び出し中のみ使用できる。TRUE
はデータオブジェクトが所有権を持ち、不要になった時点で解放しなければならないことを示す。pformatetc と pmedium
で指定されるメディウムの型は同じでなければならない。例えば、一方がグローバルハンドルでもう一方がストリームであってはならない。

情報