COleServerItem::OnRenderData

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

指定された形式でデータを取得するために、フレームワークによって呼び出されます。

virtual BOOL OnRenderData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium 
);

パラメータ

lpFormatEtc
要求された情報の形式を指定する FORMATETC 構造体へのポインタ。
lpStgMedium
データが返される STGMEDIUM 構造体へのポインタ。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

解説

この形式は、遅延レンダリングのために、DelayRenderData メンバ関数または DelayRenderFileData メンバ関数を使用して以前 COleDataSource オブジェクトに指定された形式です。この関数の既定の実装では、用意されているストレージメディアがファイルかメモリかによって、それぞれ OnRenderFileData または OnRenderGlobalData を呼び出します。この形式以外が指定されると、既定の実装では 0 を返し、何もしません。

lpStgMedium->tymed が TYMED_NULL のときは、STGMEDIUM の領域が確保され lpFormatEtc->tymed で指定されたように設定されます。TYMED_NULL ではない場合、STGMEDIUM にデータが設定されます。

これは、オーバライド可能な高度な関数です。要求された形式と媒体でデータを渡す場合は、この関数をオーバーライドします。データによっては、この関数の別のバージョンの 1 つをオーバーライドした方がよい場合があります。データのサイズが小さく、固定長の場合は、OnRenderGlobalData をオーバーライドします。データがファイルにある場合、または可変長の場合は、OnRenderFileData をオーバーライドします。

詳細については、Windows SDK の「IDataObject::GetData」、「STGMEDIUM」、「FORMATETC」、および「TYMED」を参照してください。