COleServerItem::OnSetData
更新 : 2007 年 11 月
OLE アイテムのデータを指定のデータで置き換えるために、フレームワークによって呼び出されます。
virtual BOOL OnSetData(
LPFORMATETC lpFormatEtc,
LPSTGMEDIUM lpStgMedium,
BOOL bRelease
);
パラメータ
lpFormatEtc
データの形式を指定する FORMATETC 構造体へのポインタ。lpStgMedium
データが存在する STGMEDIUM 構造体へのポインタ。bRelease
関数の呼び出し後、ストレージ メディアの所有者を示します。ストレージ メディアの代わりに確保されたリソースをだれが解放するかを、呼び出し元が決めます。呼び出し元は、これを bRelease を設定することによって決定します。bRelease が 0 以外のときは、サーバー アイテムが所有権を持ち、媒体の使用完了後にリソースを解放します。bRelease が 0 のときは、呼び出し元に所有権が残り、サーバー アイテムは、呼び出しの間のみストレージ メディアを使用できます。
戻り値
正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。
解説
サーバー アイテムは、データを正常に取得するまで、データの所有権を持ちません。つまり、0 を返したときは、所有権を持ちません。データ ソースが所有権を持っているときは、ReleaseStgMedium 関数を呼び出して、ストレージ メディアを解放します。
既定の実装では、何も行われません。OLE アイテムのデータを指定のデータで置き換えるには、この関数をオーバーライドします。これは、オーバライド可能な高度な関数です。
詳細については、Windows SDK の「STGMEDIUM」、「FORMATETC」および「ReleaseStgMedium」を参照してください。
必要条件
ヘッダー : afxole.h