COleServerItem::OnSetData

virtual BOOL OnSetData( LPFORMATETC pFormatEtc,
                        LPSTGMEDIUM pStgMedium,
                        BOOL bRelease
                      );

返回值:如果成功则返回非零值;否则返回0。

参数:
pFormatEtc指向一个FORMATETC结构的指针,此结构用来指定数据的格式。
pStgMedium指向一个STGMEDIUM结构的指针,此结构中存放数据。
bRelease指示当完成此函数调用后,谁拥有存储介质的所有权。调用者决定谁负责释放为存储介质分配的资源。调用者提供设置bRelease的值来实现这一功能。如果bRelease为一非零值,则服务器应用程序取得所有权,负责在使用完时释放介质。当bRelease为零时,调用者保留所有权,服务器项只能在此函数调用期间使用存储介质。

说明:
由框架调用这个函数,用指定数据替换此OLE项的数据。服务器项不具备此数据的所有权,直到它成功地获取此数据。也就是说,如果服务器项返回零,则它不具有所有权。如果数据源取得所有权,则它通过调用ReleaseStgMedium函数来释放存储介质。
此函数的缺省实现不做任何事情。可重载此函数来实现用指定的数据替换此OLE项的数据。该函数是一个高级的可重载函数。
如果要获取更多的信息,请参见“OLE 2程序员参考,卷1”中的STGMEDIUM,FORMATETC和ReleaseStgMedium。

请参阅:COleDataSource::OnSetData