COleDataSource::OnSetData

Artículo
02/19/2013

Llamado por el marco para establecer o reemplazar los datos del objeto de COleDataSource en el formato especificado.

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

Parámetros

lpFormatEtc
Señala la estructura de FORMATETC que especifica el formato en el que se está reemplazando los datos.
lpStgMedium
Señala la estructura de STGMEDIUM que contiene los datos que reemplacen el contenido actual del objeto de COleDataSource .
bRelease
Indica quién tiene propiedad medio de almacenamiento después de completar la llamada de función.El llamador decide quién es responsable de liberar los recursos asignados en nombre del medio de almacenamiento.El llamador hace estableciendo bRelease.Si bRelease es distinto de cero, el origen de datos toma la propiedad, y libera el medio cuando ha terminado de usarla.Cuando bRelease es 0, el llamador conserva propiedad y el origen de datos puede utilizar el medio de almacenamiento sólo mientras dure la llamada.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

El origen de datos no toma los propietarios de los datos hasta que la haya obtenido correctamente.Es decir, no toma propiedad si OnSetData devuelve 0.Si el origen de datos toma propiedad, libera el medio de almacenamiento llamando a la función de ReleaseStgMedium .

La implementación predeterminada no hace nada.invalide esta función para reemplazar los datos en el formato especificado.éste es un overridable avanzado.

Para obtener más información, vea STGMEDIUM y estructuras de FORMATETC y ReleaseStgMedium y IDataObject:: GetData funciona en Windows SDK*.*