COleDataSource::OnRenderGlobalData
Called by the framework to retrieve data in the specified format when the specified storage medium is global memory.
virtual BOOL OnRenderGlobalData(
LPFORMATETC lpFormatEtc,
HGLOBAL* phGlobal
);
Parameters
lpFormatEtc
Points to the FORMATETC structure specifying the format in which information is requested.phGlobal
Points to a handle to global memory in which the data is to be returned. If one has not yet been allocated, this parameter can be NULL.
Return Value
Nonzero if successful; otherwise 0.
Remarks
The specified format is one previously placed in the COleDataSource object using the DelayRenderData member function for delayed rendering. The default implementation of this function simply returns FALSE.
If phGlobal is NULL, then a new HGLOBAL should be allocated and returned in phGlobal. Otherwise, the HGLOBAL specified by phGlobal should be filled with the data. The amount of data placed in the HGLOBAL must not exceed the current size of the memory block. Also, the block cannot be reallocated to a larger size.
This is an advanced overridable. Override this function to supply your data in the requested format and medium. Depending on your data, you may want to override one of the other versions of this function instead. If you want to handle multiple storage media, override OnRenderData. If your data is in a file, or is of variable size, override OnRenderFileData. For more information on delayed rendering as handled by MFC, see the article Data Objects and Data Sources: Manipulation.
For more information, see the FORMATETC structure and IDataObject::GetData in the Windows SDK*.*
Requirements
Header: afxole.h
See Also
Concepts
COleDataSource::DelayRenderData
COleDataSource::DelayRenderFileData