COleDataSource::OnSetData

virtuelleBOOLOnSetData (bReleaseLPFORMATETCLpFormatEtc,LPSTGMEDIUMLpStgMedium,BOOL);

Rückgabewert

Ungleich NULL, wenn erfolgreich; andernfalls 0.

Parameter

lpFormatEtc

Verweist auf die Angabe des Formats, in dem Daten ersetzt wird, FORMATETC -Struktur.

lpStgMedium

Verweist auf die STGMEDIUM -Struktur, enthält die Daten, die den aktuellen Inhalt des Objekts COleDataSource ersetzen werden.

bRelease

Gibt an, die Besitzer des Speichermediums ist nach Abschluss des Funktionsaufrufs. Der Aufrufer entscheidet, wer ist verantwortlich für die Freigabe der Mittel für das Speichermedium. Der Anrufer tut dies, indem Einstellung bRelease. Wenn bRelease ungleich NULL ist, den Besitz, das Medium freigeben, wenn es abgeschlossen ist, verwenden sie die Datenquelle übernimmt. Wenn bRelease 0 ist, der Aufrufer behält sich das Eigentum und die Datenquelle können das Speichermedium nur für die Dauer des Anrufs.

Bemerkungen

Wird von den Rahmen festlegen, oder ersetzen Sie die Daten im COleDataSource -Objekt im angegebenen Format. Die Datenquelle dauert nicht Besitz der Daten, bis er es erfolgreich erhalten hat. Das heißt, dauert es nicht Besitz wenn OnSetData 0 zurückgibt. Wenn die Datenquelle den Besitz übernimmt, es befreit das Speichermedium durch Aufrufen der ReleaseStgMedium -Funktion.

Die Standardimplementierung tut nichts. Überschreiben Sie diese Funktion, um die Daten im angegebenen Format zu ersetzen. Dies ist eine erweiterte überschreibbar.

Weitere Informationen finden Sie unter der STGMEDIUM und FORMATETC -Strukturen und der ReleaseStgMedium und IDataObject:: GetData Funktionen in der OLE 2 Programmer's Reference, Volume 1.

COleDataSource ÜbersichtMember der Klasse | Hierarchiediagramm

Siehe auch&Nbsp;COleDataSource::DelaySetData, COleDataSource::OnRenderData, COleDataSource::OnRenderFileData, COleDataSource::OnRenderGlobalData, COleServerItem::OnSetData

Index