Clase IDataObjectImpl

Esta clase proporciona métodos para admitir Transferencia de datos uniforme y administrar conexiones.

Importante

Esta clase y sus miembros no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.

Sintaxis

template<class T>
class IDataObjectImpl

Parámetros

T
La clase, que se deriva de IDataObjectImpl.

Miembros

Métodos públicos

Nombre	Descripción
IDataObjectImpl::DAdvise	Establece una conexión entre el objeto de datos y el receptor de recomendaciones. Esto permite al receptor de recomendaciones recibir notificaciones de cambios en el objeto.
IDataObjectImpl::DUnadvise	Finaliza una conexión previamente establecida mediante DAdvise.
IDataObjectImpl::EnumDAdvise	Crea un enumerador para recorrer en iteración las conexiones de aviso actuales.
IDataObjectImpl::EnumFormatEtc	Crea un enumerador para recorrer en iteración las FORMATETC estructuras admitidas por el objeto de datos. La implementación ATL devuelve E_NOTIMPL.
IDataObjectImpl::FireDataChange	Devuelve una notificación de cambio a cada receptor de recomendaciones.
IDataObjectImpl::GetCanonicalFormatEtc	Recupera una estructura FORMATETC que es lógicamente equivalente a una más compleja. La implementación ATL devuelve E_NOTIMPL.
IDataObjectImpl::GetData	Transfiere datos del objeto de datos al cliente. Los datos se describen en una estructura FORMATETC y se transfieren mediante una estructura STGMEDIUM.
IDataObjectImpl::GetDataHere	Es similar a GetData, excepto que el cliente debe asignar la estructura STGMEDIUM. La implementación ATL devuelve E_NOTIMPL.
IDataObjectImpl::QueryGetData	Determina si el objeto de datos admite una estructura determinada FORMATETC para transferir datos. La implementación ATL devuelve E_NOTIMPL.
IDataObjectImpl::SetData	Transfiere datos del cliente al objeto de datos. La implementación ATL devuelve E_NOTIMPL.

Comentarios

La interfaz IDataObject proporciona métodos para admitir la Transferencia uniforme de datos. IDataObject usa las estructuras de formato estándar FORMATETC y STGMEDIUM para recuperar y almacenar los datos.

IDataObject también administra las conexiones a los receptores de recomendaciones para controlar las notificaciones de cambio de datos. Para que el cliente reciba notificaciones de cambio de datos del objeto de datos, el cliente debe implementar la interfaz IAdviseSink en un objeto llamado receptor de recomendaciones. Cuando el cliente llama a IDataObject::DAdvise, se establece una conexión entre el objeto de datos y el receptor de recomendaciones.

La clase IDataObjectImpl proporciona una implementación predeterminada de IDataObject e implementa IUnknown mediante el envío de información al dispositivo de volcado de memoria en las compilaciones de depuración.

Artículos relacionadosTutorial ATL, Creación de un proyecto ATL

Jerarquía de herencia

IDataObject

IDataObjectImpl

Requisitos

Encabezado: atlctl.h

IDataObjectImpl::DAdvise

Establece una conexión entre el objeto de datos y el receptor de recomendaciones.

HRESULT DAdvise(
    FORMATETC* pformatetc,
    DWORD advf,
    IAdviseSink* pAdvSink,
    DWORD* pdwConnection);

Comentarios

Esto permite al receptor de recomendaciones recibir notificaciones de cambios en el objeto.

Llame a DUnadvise para finalizar la conexión.

Consulte IDataObject::DAdvise en Windows SDK.

IDataObjectImpl::DUnadvise

Finaliza una conexión previamente establecida mediante DAdvise.

HRESULT DUnadvise(DWORD dwConnection);

Comentarios

Consulte IDataObject::D Unadvise en Windows SDK.

IDataObjectImpl::EnumDAdvise

Crea un enumerador para recorrer en iteración las conexiones de aviso actuales.

HRESULT DAdvise(
    FORMATETC* pformatetc,
    DWORD advf,
    IAdviseSink* pAdvSink,
    DWORD* pdwConnection);

Comentarios

Consulte IDataObject::EnumDAdvise en Windows SDK.

IDataObjectImpl::EnumFormatEtc

Crea un enumerador para recorrer en iteración las FORMATETC estructuras admitidas por el objeto de datos.

HRESULT EnumFormatEtc(
    DWORD dwDirection,
    IEnumFORMATETC** ppenumFormatEtc);

Comentarios

Consulte IDataObject::EnumFormatEtc en Windows SDK.

Valor devuelto

Devuelve E_NOTIMPL.

IDataObjectImpl::FireDataChange

Devuelve una notificación de cambio a cada receptor de recomendaciones que se está administrando actualmente.

HRESULT FireDataChange();

Valor devuelto

Valor HRESULT estándar.

IDataObjectImpl::GetCanonicalFormatEtc

Recupera una estructura FORMATETC que es lógicamente equivalente a una más compleja.

HRESULT GetCanonicalFormatEtc(FORMATETC* pformatetcIn, FORMATETC* pformatetcOut);

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Consulte IDataObject::GetCanonicalFormatEtc en Windows SDK.

IDataObjectImpl::GetData

Transfiere datos del objeto de datos al cliente.

HRESULT GetData(
    FORMATETC* pformatetcIn,
    STGMEDIUM* pmedium);

Comentarios

El parámetro pformatetcIn debe especificar el tipo de medio de almacenamiento TYMED_MFPICT.

Consulte IDataObject::GetData en Windows SDK.

IDataObjectImpl::GetDataHere

Es similar a GetData, excepto que el cliente debe asignar la estructura STGMEDIUM.

HRESULT GetDataHere(
    FORMATETC* pformatetc,
    STGMEDIUM* pmedium);

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Consulte IDataObject::GetDataHere en Windows SDK.

IDataObjectImpl::QueryGetData

Determina si el objeto de datos admite una estructura determinada FORMATETC para transferir datos.

HRESULT QueryGetData(FORMATETC* pformatetc);

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Consulte IDataObject::QueryGetData en Windows SDK.

IDataObjectImpl::SetData

Transfiere datos del cliente al objeto de datos.

HRESULT SetData(
    FORMATETC* pformatetc,
    STGMEDIUM* pmedium,
    BOOL fRelease);

Valor devuelto

Devuelve E_NOTIMPL.

Comentarios

Consulte IDataObject::SetData en Windows SDK.

Consulte también

Información general sobre la clase