Share via


IDataObject-Schnittstelle (objidl.h)

Ermöglicht die Datenübertragung und Benachrichtigung über Datenänderungen. Datenübertragungsmethoden geben das Format der übertragenen Daten zusammen mit dem Medium an, über das die Daten übertragen werden sollen. Optional können die Daten für ein bestimmtes Zielgerät gerendert werden. Zusätzlich zu Den Methoden zum Abrufen und Speichern von Daten gibt die IDataObject-Schnittstelle Methoden zum Auflisten verfügbarer Formate und zum Verwalten von Verbindungen mit Beratungssenken für die Behandlung von Änderungsbenachrichtigungen an.

Der Begriff Datenobjekt wird für jedes Objekt verwendet, das eine Implementierung der IDataObject-Schnittstelle unterstützt. Die Implementierungen variieren je nachdem, was das Datenobjekt tun muss. in einigen Datenobjekten kann die Implementierung bestimmter Methoden, die vom Objekt nicht unterstützt werden, einfach die Rückgabe von E_NOTIMPL sein. Bei einigen Datenobjekten können Aufrufer beispielsweise keine Daten senden. Andere Datenobjekte unterstützen keine Beratungsverbindungen und Änderungsbenachrichtigungen. Für datenobjekte, die Änderungsbenachrichtigungen unterstützen, stellt OLE jedoch ein Objekt bereit, das als Datenhinweishalter bezeichnet wird. Ein Schnittstellenzeiger auf diesen Halter ist über einen Aufruf der Hilfsfunktion CreateDataAdviseHolder verfügbar. Ein Datenobjekt kann über mehrere Verbindungen verfügen, die jeweils über einen eigenen Satz von Attributen verfügen. Der OLE-Daten-Empfehlungsinhaber vereinfacht die Verwaltung dieser Verbindungen und das Senden der entsprechenden Benachrichtigungen.

Vererbung

Die IDataObject-Schnittstelle erbt von der IUnknown-Schnittstelle . IDataObject verfügt auch über folgende Membertypen:

Methoden

Die IDataObject-Schnittstelle verfügt über diese Methoden.

 
IDataObject::D Advise

Wird von einem Objekt aufgerufen, das eine Empfehlungssenke unterstützt, um eine Verbindung zwischen einem Datenobjekt und der Empfehlungssenke herzustellen. Dadurch kann die Empfehlungssenke über Änderungen an den Daten des Objekts benachrichtigt werden.
IDataObject::D Unadvise

Zerstört eine zuvor eingerichtete Benachrichtigungsverbindung.
IDataObject::EnumDAdvise

Erstellt ein Objekt, mit dem die aktuellen Advise-Verbindungen aufgelistet werden können.
IDataObject::EnumFormatEtc

Erstellt ein -Objekt, um die von einem Datenobjekt unterstützten Formate aufzulisten.
IDataObject::GetCanonicalFormatEtc

Stellt eine potenziell andere, aber logisch gleichwertige FORMATTC-Struktur bereit. Sie verwenden diese Methode, um zu bestimmen, ob zwei verschiedene FORMATETC-Strukturen die gleichen Daten zurückgeben würden, sodass keine doppelten Renderings erforderlich sind.
IDataObject::GetData

Wird von einem Datenconsumer aufgerufen, um Daten aus einem Quelldatenobjekt abzurufen.
IDataObject::GetDataHere

Wird von einem Datenconsumer aufgerufen, um Daten aus einem Quelldatenobjekt abzurufen. Diese Methode unterscheidet sich von der GetData-Methode darin, dass der Aufrufer das angegebene Speichermedium zuordnen und freigeben muss.
IDataObject::QueryGetData

Bestimmt, ob das Datenobjekt die Daten wie beschrieben rendern kann. Objekte, die einen Einfüge- oder Löschvorgang versuchen, können diese Methode aufrufen, bevor IDataObject::GetData aufgerufen wird, um einen Hinweis darauf zu erhalten, ob der Vorgang erfolgreich ist.
IDataObject::SetData

Wird von einem Objekt aufgerufen, das eine Datenquelle enthält, um Daten an das Objekt zu übertragen, das diese Methode implementiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile objidl.h