Klasse IDataObjectImpl

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Deze klasse biedt methoden voor het ondersteunen van Uniform Data Transfer en het beheren van verbindingen.

Belangrijk

Deze klasse en de bijbehorende leden kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

Syntaxis

template<class T>
class IDataObjectImpl

Parameterwaarden

T
Uw klas, afgeleid van IDataObjectImpl.

Leden

Openbare methoden

Naam	Description
IDataObjectImpl::D Toevoegen	Hiermee wordt een verbinding tot stand gebracht tussen het gegevensobject en een adviserende sink. Hierdoor kan de adviserende sink meldingen ontvangen van wijzigingen in het object.
IDataObjectImpl::D Unadvise	Hiermee wordt een eerder tot stand gebrachte verbinding beëindigd via DAdvise.
IDataObjectImpl::EnumDAdvise	Hiermee maakt u een enumerator om de huidige adviesverbindingen te doorlopen.
IDataObjectImpl::EnumFormatetc	Hiermee maakt u een enumerator om de FORMATETC structuren te herhalen die worden ondersteund door het gegevensobject. De ATL-implementatie retourneert E_NOTIMPL.
IDataObjectImpl::FireDataChange	Stuurt een wijzigingsmelding terug naar elke advies-sink.
IDataObjectImpl::GetCanonicalFormatEtc	Haalt een logisch equivalente FORMATETC structuur op die complexer is. De ATL-implementatie retourneert E_NOTIMPL.
IDataObjectImpl::GetData	Draagt gegevens over van het gegevensobject naar de client. De gegevens worden beschreven in een FORMATETC structuur en worden overgebracht via een STGMEDIUM structuur.
IDataObjectImpl::GetDataHere	Vergelijkbaar met GetData, behalve dat de client de STGMEDIUM structuur moet toewijzen. De ATL-implementatie retourneert E_NOTIMPL.
IDataObjectImpl::QueryGetData	Bepaalt of het gegevensobject een bepaalde FORMATETC structuur ondersteunt voor het overdragen van gegevens. De ATL-implementatie retourneert E_NOTIMPL.
IDataObjectImpl::SetData	Hiermee worden gegevens van de client overgedragen naar het gegevensobject. De ATL-implementatie retourneert E_NOTIMPL.

Opmerkingen

De IDataObject-interface biedt methoden voor de ondersteuning van Uniform Data Transfer. IDataObject maakt gebruik van de indelingsstructuren FORMATETC en STGMEDIUM om gegevens op te halen en op te slaan.

IDataObject beheert ook verbindingen om sinks te adviseren om meldingen over gegevenswijziging af te handelen. Om de client meldingen over gegevenswijziging van het gegevensobject te kunnen ontvangen, moet de client de IAdviseSink-interface implementeren op een object dat een adviessink wordt genoemd. Wanneer de client vervolgens aanroept IDataObject::DAdvise, wordt er een verbinding tot stand gebracht tussen het gegevensobject en de adviserende sink.

Klasse IDataObjectImpl biedt een standaard implementatie van IDataObject en implementeert door informatie te verzenden naar het dumpapparaat in foutopsporingsversies IUnknown .

Gerelateerde artikelenATL-zelfstudie, een ATL-project maken

Overnamehiërarchie

IDataObject

IDataObjectImpl

Requirements

Koptekst: atlctl.h

IDataObjectImpl::D Toevoegen

Hiermee wordt een verbinding tot stand gebracht tussen het gegevensobject en een adviserende sink.

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

Opmerkingen

Hierdoor kan de adviserende sink meldingen ontvangen van wijzigingen in het object.

Als u de verbinding wilt beëindigen, roept u DUnadvise aan.

Zie IDataObject::D Toevoegen in de Windows SDK.

IDataObjectImpl::D Unadvise

Hiermee wordt een eerder tot stand gebrachte verbinding via DAdvise beëindigd.

HRESULT DUnadvise(DWORD dwConnection);

Opmerkingen

Zie IDataObject::D Unadvise in de Windows SDK.

IDataObjectImpl::EnumDAdvise

Hiermee maakt u een enumerator om de huidige adviesverbindingen te doorlopen.

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

Opmerkingen

Zie IDataObject::EnumDAdvise in de Windows SDK.

IDataObjectImpl::EnumFormatetc

Hiermee maakt u een enumerator om de FORMATETC structuren te herhalen die worden ondersteund door het gegevensobject.

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

Opmerkingen

Zie IDataObject::EnumFormatEtc in de Windows SDK.

Retourwaarde

Retourneert E_NOTIMPL.

IDataObjectImpl::FireDataChange

Hiermee wordt een wijzigingsmelding teruggestuurd naar elke advies-sink die momenteel wordt beheerd.

HRESULT FireDataChange();

Retourwaarde

Een standaard HRESULT-waarde.

IDataObjectImpl::GetCanonicalFormatEtc

Haalt een logisch equivalente FORMATETC structuur op die complexer is.

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

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Zie IDataObject::GetCanonicalFormatEtc in de Windows SDK.

IDataObjectImpl::GetData

Draagt gegevens over van het gegevensobject naar de client.

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

Opmerkingen

De parameter pformatetcIn moet een opslagmediumtype van TYMED_MFPICT opgeven.

Zie IDataObject::GetData in de Windows SDK.

IDataObjectImpl::GetDataHere

Vergelijkbaar met GetData, behalve dat de client de STGMEDIUM structuur moet toewijzen.

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

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Zie IDataObject::GetDataHere in de Windows SDK.

IDataObjectImpl::QueryGetData

Bepaalt of het gegevensobject een bepaalde FORMATETC structuur ondersteunt voor het overdragen van gegevens.

HRESULT QueryGetData(FORMATETC* pformatetc);

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Zie IDataObject::QueryGetData in de Windows SDK.

IDataObjectImpl::SetData

Hiermee worden gegevens van de client overgedragen naar het gegevensobject.

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

Retourwaarde

Retourneert E_NOTIMPL.

Opmerkingen

Zie IDataObject::SetData in de Windows SDK.

Zie ook

Overzicht van klassen