COleDataSource::OnSetData

virtual BOOL OnSetData ( LPFORMATETC lpFormatEtc, LPSTGMEDIUM lpStgMedium, BOOL bRelease );

Valor devuelto

Distinto de cero si es correcto; caso contrario 0.

Parámetros

lpFormatEtc

Apunta a la estructura FORMATETC especifica el formato en el que está siendo reemplazados datos.

lpStgMedium

Apunta a la estructura STGMEDIUM que contiene los datos que reemplazarán el contenido actual del objeto COleDataSource.

bRelease

Indica que tiene la propiedad del medio de almacenamiento después de completar la llamada a la función. El llamador decide quién es responsable de liberar los recursos asignados por el medio de almacenamiento. El llamador para ello por valor de bRelease. Si bRelease es distinto de cero, el origen de datos toma posesión, liberando el medio cuando termine de usarlo. Cuando bRelease es 0, el llamador conserva la propiedad y el origen de datos puede utilizar el medio de almacenamiento sólo para la duración de la llamada.

Observaciones

Llamado por el marco para establecer o reemplazar los datos en el objeto COleDataSource en el formato especificado. El origen de datos no tomar posesión de los datos hasta que ha obtenido con éxito. Es decir, no tome posesión si OnSetData devuelve 0. Si el origen de datos toma posesión, libera el medio de almacenamiento llamando a la función ReleaseStgMedium.

La implementación predeterminada no hace nada. Reemplazar esta función para reemplazar los datos en el formato especificado. Se trata de una avanzada reemplazable.

Para obtener más información, consulte el STGMEDIUM y estructuras FORMATETC y el ReleaseStgMedium y IDataObject::GetData funciona en la referencia del programador 2 OLE, volumen 1.

I&ntroducción a COleDataSource |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;COleDataSource::DelaySetData, COleDataSource::OnRenderData, COleDataSource::OnRenderFileData, COleDataSource::OnRenderGlobalData, COleServerItem::OnSetData

Index