COleDataSource::OnSetData

Artikel
02/26/2013

Aufgerufen durch das Framework, um die Daten im COleDataSource-Objekt im angegebenen Format festzulegen oder zu ersetzen.

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

Parameter

lpFormatEtc
Zeigt auf die FORMATETC-Struktur, die das Format angeben, in dem Daten ersetzt werden.
lpStgMedium
Zeigt auf die STGMEDIUM-Struktur, die die Daten enthält, die den aktuellen Inhalt COleDataSource ersetzen, ein Objekt.
bRelease
Gibt an, wer Besitzer des Speichermediums hat, nach dem Funktionsaufruf abgeschlossen hat.Der Aufrufer entscheidet, die für das Freigeben der Ressourcen zuständig ist, die im Namen des Speichermediums zugeordnet werden.Der Aufrufer erfolgt, indem er bRelease festgelegt wird.Wenn bRelease ungleich 0 (null) ist, nimmt die Datenquelle den Besitz und gibt den Medium frei, wenn die Verwendung sie beendet wurde.Wenn bRelease 0 ist, behält der Aufrufer Besitz bei und die Datenquelle kann das Speichermedium nur für die Dauer des Aufrufs verwenden.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Die Datenquelle nimmt nicht Besitz der Daten, bis sie erfolgreich es weist.Das heißt, nimmt sie nicht Besitz wenn OnSetData gibt 0 zurück.Wenn die Datenquelle Besitz akzeptiert, gibt sie das Speichermedium frei, indem sie die ReleaseStgMedium-Funktion aufrufen.

Bei der Standardimplementierung wird keine Aktion ausgeführt.Überschreiben Sie diese Funktion, um die Daten im angegebenen Format zu ersetzen.Dies ist ein erweitertes schreibbar gekennzeichnet.

Weitere Informationen finden Sie in STGMEDIUM und FORMATETC-Strukturen und die ReleaseStgMedium und IDataObject::GetData-Funktionen in Windows SDK*.*