Freigeben über


COleServerItem::OnSetData

Aufgerufen vom Framework, um die Daten des OLE-Elements durch die angegebenen Daten zu ersetzen.

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

Parameter

  • lpFormatEtc
    Zeiger auf eine Struktur FORMATETC das Format der Daten angibt.

  • lpStgMedium
    Zeiger auf eine STGMEDIUM-Struktur, in der die Daten befinden.

  • 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, wird das Serverelement den Besitz und gibt den Medium frei, wenn mit es beendet wurde. Wenn bRelease 0 ist, behält der Aufrufer Besitz bei und das Serverelement kann das Speichermedium nur für die Dauer des Aufrufs verwenden.

Rückgabewert

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

Hinweise

Das Serverelement akzeptiert nicht Besitz der Daten, bis sie erfolgreich es weist. Das heißt, nimmt das nicht Besitz, wenn 0 zurückgibt. 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 des OLE-Elements durch die angegebenen Daten zu ersetzen. Dies ist ein erweitertes schreibbar gekennzeichnet.

Weitere Informationen finden Sie unter STGMEDIUM, FORMATETC und ReleaseStgMedium in Windows SDK.

Anforderungen

Header: afxole.h

Siehe auch

Referenz

COleServerItem-Klasse

Hierarchiediagramm

COleDataSource::OnSetData