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