Share via


COleServerItem::OnSetData

Llamado por el marco para reemplazar los datos de OLE de elementos con los datos especificados.

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

Parámetros

  • lpFormatEtc
    puntero a una estructura de FORMATETC que especifica el formato de los datos.

  • lpStgMedium
    Puntero a una estructura de STGMEDIUM en la que los datos residen.

  • 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 elemento del servidor tiene la propiedad, y libera el medio cuando ha terminado de usarla.Cuando bRelease es 0, el llamador conserva propiedad y el elemento del servidor puede utilizar el medio de almacenamiento sólo mientras dure la llamada.

Valor devuelto

Distinto de cero si correctamente; si no 0.

Comentarios

El elemento del servidor no toma los propietarios de los datos hasta que la haya obtenido correctamente.Es decir, no toma propiedad si 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 de OLE de elementos con los datos especificados.éste es un overridable avanzado.

Para obtener más información, vea STGMEDIUM, FORMATETC, y ReleaseStgMedium en Windows SDK.

Requisitos

encabezado: afxole.h

Vea también

Referencia

Clase de COleServerItem

Gráfico de jerarquía

COleDataSource::OnSetData