DataObject.IDataObject.GetData(FORMATETC, STGMEDIUM) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mendapatkan data dari objek data sumber. Metode GetData(FORMATETC, STGMEDIUM) , yang dipanggil oleh konsumen data, merender data yang dijelaskan dalam struktur yang ditentukan FORMATETC dan mentransfernya melalui struktur yang ditentukan STGMEDIUM . Pemanggil kemudian bertanggung jawab untuk melepaskan STGMEDIUM struktur.
virtual void System.Runtime.InteropServices.ComTypes.IDataObject.GetData(System::Runtime::InteropServices::ComTypes::FORMATETC % formatetc, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::STGMEDIUM % medium) = System::Runtime::InteropServices::ComTypes::IDataObject::GetData;
void IDataObject.GetData (ref System.Runtime.InteropServices.ComTypes.FORMATETC formatetc, out System.Runtime.InteropServices.ComTypes.STGMEDIUM medium);
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetData : FORMATETC * STGMEDIUM -> unit
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetData : FORMATETC * STGMEDIUM -> unit
Sub GetData (ByRef formatetc As FORMATETC, ByRef medium As STGMEDIUM) Implements IDataObject.GetData
Parameter
- formatetc
- FORMATETC
Penunjuk ke FORMATETC struktur, diteruskan oleh referensi, yang menentukan format, sedang, dan perangkat target untuk digunakan saat meneruskan data. Dimungkinkan untuk menentukan lebih dari satu media dengan menggunakan operator Boolean OR, memungkinkan metode untuk memilih media terbaik di antara yang ditentukan.
- medium
- STGMEDIUM
Ketika metode ini kembali, berisi penunjuk ke STGMEDIUM struktur yang menunjukkan media penyimpanan yang berisi data yang dikembalikan melalui anggotanya tymed , dan tanggung jawab untuk melepaskan media melalui nilai anggotanya pUnkForRelease . Jika pUnkForRelease adalah null
, penerima media bertanggung jawab untuk merilisnya; jika tidak, pUnkForRelease menunjuk ke IUnknown
antarmuka pada objek yang sesuai sehingga metodenya Release
dapat dipanggil. Media harus dialokasikan dan diisi oleh GetData(FORMATETC, STGMEDIUM). Parameter ini diteruskan tanpa diinisialisasi.
Penerapan
Pengecualian
Memori tidak cukup untuk melakukan operasi ini.
Keterangan
Anggota ini adalah implementasi anggota antarmuka eksplisit. Ini hanya dapat digunakan ketika dilemparkan DataObject ke IDataObject antarmuka.