COleDataSource::OnRenderGlobalData

Artículo
02/19/2013

Llamado por el marco para recuperar datos en el formato especificado cuando el medio de almacenamiento especificado es memoria global.

virtual BOOL OnRenderGlobalData(
   LPFORMATETC lpFormatEtc,
   HGLOBAL* phGlobal 
);

Parámetros

lpFormatEtc
Señala la estructura de FORMATETC que especifica el formato en el que se solicita información.
phGlobal
Señala un identificador a memoria global en el que los datos debe volver.Si aún no se ha asignado, este parámetro puede ser NULL.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

El formato especificado es uno colocado previamente en el objeto de COleDataSource utilizando la función miembro de DelayRenderData para generar retrasada.La implementación predeterminada de esta función simplemente devuelve FALSO.

Si phGlobal es NULL, después nuevo HGLOBAL se debe asignar y devolver en phGlobal.Si no, HGLOBAL especificado por phGlobal se debe rellenar con datos.La cantidad de datos guardados en HGLOBAL no debe superar el tamaño actual del bloque de memoria.Además, el bloque no se puede reasignar a un tamaño.

éste es un overridable avanzado.Invalide esta función para proporcionar los datos en el formato y mediano solicitados.Dependiendo de los datos, puede que desee reemplazar una de las otras versiones de esta función en su lugar.Si desea controlar los medios de almacenamiento múltiples, reemplace OnRenderData.Si los datos se encuentra en un archivo, o es de tamaño variable, reemplace OnRenderFileData.Para obtener más información acerca de cómo generar retrasada como controlado por MFC, vea el artículo objetos de datos y orígenes de datos: manipulación.

Para obtener más información, vea la estructura y IDataObject::GetData de FORMATETC en Windows SDK*.*