COleServerItem::OnRenderGlobalData
virtual BOOL OnRenderGlobalData( LPFORMATETC lpFormatEtc, HGLOBAL* phGlabal );
返回值:如果成功则返回非零值;否则返回0。
参数:
lpFormatEtc
指向一个FORMATETC结构,此结构指定所请求信息的格式。
phGlobal
指向一个全局内存句柄,此全局内存将存放所返回的数据。如果没有分配内存,则该参数可以是NULL。
说明:
当指定的存储介质是全局内存时,框架调用此函数以检取指定格式的数据。指定格式是先前用DelayRenderData成员函数进行延迟提交时放入COleDataSource对象中的格式。OnRenderGlobalData函数的缺省实现只是简单返回FALSE。
如果phGlobal为NULL,则将分配一个新HGLOBAL,并在phGlobal中返回此HGLOBAL。否则,将用数据填充phGlobal所指定的HGLOBAL。放入HGLOBAL中的数据量不能超过此内存块的当前大小。并且,此内存块不能再分配成更大的尺寸。
OnRenderGlobalData是一个高级的可重载函数。可以重载此函数来提供所请求格式和介质中的数据。根据数据的不同,应用程序可能想要加载该函数的其它一种版本来代替。如果想要处理多种存储介质,可以重载OnRenderData函数;如果数据放在文件中,或者数据的大小可变,则重载OnRenderFileData函数。
如果要获取更多的信息,请参见“OLE 2程序员参考,卷1”中的STGMEDIUM,FORMATETC和ReleaseStgMedium。
请参阅:COleServerItem::OnRecordData