IDataObject.GetData(FORMATETC, STGMEDIUM) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft Daten aus einem Quelldatenobjekt ab. Die von einem Datennutzer aufgerufene GetData(FORMATETC, STGMEDIUM)-Methode rendert die in der angegebenen FORMATETC-Struktur beschriebenen Daten und überträgt diese über die angegebene STGMEDIUM-Struktur. Der Aufrufer ist dann für das Freigeben der STGMEDIUM-Struktur verantwortlich.
public:
void GetData(System::Runtime::InteropServices::ComTypes::FORMATETC % format, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::STGMEDIUM % medium);
public void GetData (ref System.Runtime.InteropServices.ComTypes.FORMATETC format, out System.Runtime.InteropServices.ComTypes.STGMEDIUM medium);
abstract member GetData : FORMATETC * STGMEDIUM -> unit
Public Sub GetData (ByRef format As FORMATETC, ByRef medium As STGMEDIUM)
Parameter
- format
- FORMATETC
Ein Zeiger auf eine FORMATETC-Struktur, der als Verweis übergeben wird und das Format, das Medium und das Zielgerät für das Übergeben der Daten definiert. Mithilfe des booleschen Operators OR können auch mehrere Medien angegeben werden, sodass die Methode das beste Medium aus den angegebenen Medien auswählen kann.
- medium
- STGMEDIUM
Enthält nach dem Beenden dieser Methode einen Zeiger auf die STGMEDIUM-Struktur, die das Speichermedium angibt, das die zurückgegebenen Daten in ihrem tymed-Member enthält, sowie die Verantwortung für das Freigeben des Mediums in ihrem pUnkForRelease-Member. Wenn pUnkForReleasenull
ist, ist der Empfänger des Mediums für dessen Freigabe verantwortlich, andernfalls zeigt pUnkForRelease auf die IUnknown
-Schnittstelle im entsprechenden Objekt, sodass dessen Release
-Methode aufgerufen werden kann. Das Medium muss zugeordnet und von GetData(FORMATETC, STGMEDIUM) aufgefüllt werden. Dieser Parameter wird nicht initialisiert übergeben.
Hinweise
Weitere Informationen finden Sie unter IDataObject::GetData-Methode.