COleDataSource::OnSetData

调用由框架设置或替换在 COleDataSource 对象的数据是否采用指定的格式。

virtual BOOL OnSetData(
   LPFORMATETC lpFormatEtc,
   LPSTGMEDIUM lpStgMedium,
   BOOL bRelease 
);

参数

  • lpFormatEtc
    指向 FORMATETC 指定数据已替换的布局的框架。

  • lpStgMedium
    指向 STGMEDIUM 包含要替换 COleDataSource 对象的当前内容的数据的结构。

  • bRelease
    指示其具有所有权存储媒介在完成之后函数调用。调用方确定谁到发布委托存储媒介已分配的资源负责。调用方通过设置 bRelease执行此操作。如果 bRelease 不为零,数据源采用所有权,释放中使用它时,那么,当已完成。当 bRelease 为0时,调用方保留所有权,而数据源可以在调用期间仅用于存储媒介。

返回值

非零,如果成功;否则为0。

备注

数据源未采用数据的所有权,直到成功获取为。也就是说,如果 OnSetData 返回0;它不采用所有权。如果数据源采用所有权,通过调用 ReleaseStgMedium 函数释放存储媒介。

默认实现不执行任何操作。重写此函数替换指定格式的数据。这是一个高级可重写。

有关更多信息,请参见 STGMEDIUMFORMATETC 结构和 ReleaseStgMediumIDataObject::GetData 函数在 Windows SDK*。*

要求

Header: afxole.h

请参见

参考

COleDataSource选件类

层次结构图

COleDataSource::DelaySetData

COleDataSource::OnRenderData

COleDataSource::OnRenderFileData

COleDataSource::OnRenderGlobalData

COleServerItem::OnSetData