IDataObject.GetData(FORMATETC, STGMEDIUM) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Získá data ze zdrojového datového objektu. Metoda GetData(FORMATETC, STGMEDIUM) , kterou volá příjemce dat, vykreslí data popsaná v zadané FORMATETC struktuře a přenese je přes zadanou STGMEDIUM strukturu. Volající pak převezme odpovědnost za uvolnění STGMEDIUM struktury.
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)
Parametry
- format
- FORMATETC
Ukazatel na FORMATETC strukturu předanou odkazem, která definuje formát, médium a cílové zařízení, které se má použít při předávání dat. Pomocí logického operátoru OR je možné zadat více než jedno médium, což metodě umožňuje zvolit nejlepší médium ze zadaných médií.
- medium
- STGMEDIUM
Když se tato metoda vrátí, obsahuje ukazatel na STGMEDIUM strukturu, která označuje úložné médium obsahující vrácená data prostřednictvím svého tymed člena a odpovědnost za uvolnění média prostřednictvím hodnoty jeho pUnkForRelease členu. Pokud pUnkForRelease je null
, příjemce média je zodpovědný za jeho uvolnění; v opačném případě pUnkForRelease odkazuje IUnknown
na rozhraní příslušného objektu, aby jeho Release
metodu bylo možné volat. Médium musí být přiděleno a vyplněno pomocí GetData(FORMATETC, STGMEDIUM). Tento parametr se předává neinicializovaný.
Poznámky
Další informace najdete v tématu Metoda IDataObject::GetData.