DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

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.

Menyediakan struktur standar FORMATETC yang secara logis setara dengan struktur yang lebih kompleks. Gunakan metode ini untuk menentukan apakah dua struktur yang berbeda FORMATETC akan mengembalikan data yang sama, menghapus kebutuhan akan penyajian duplikat.

 virtual int System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc(System::Runtime::InteropServices::ComTypes::FORMATETC % pformatetcIn, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::FORMATETC % pformatetcOut) = System::Runtime::InteropServices::ComTypes::IDataObject::GetCanonicalFormatEtc;

int IDataObject.GetCanonicalFormatEtc (ref System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcIn, out System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcOut);

abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int

Function GetCanonicalFormatEtc (ByRef pformatetcIn As FORMATETC, ByRef pformatetcOut As FORMATETC) As Integer Implements IDataObject.GetCanonicalFormatEtc

Parameter

pformatetcIn: FORMATETC

Penunjuk ke FORMATETC struktur, diteruskan oleh referensi, yang menentukan format, menengah, dan perangkat target yang ingin digunakan pemanggil untuk mengambil data dalam panggilan berikutnya seperti GetData(FORMATETC, STGMEDIUM). Anggota TYMED tidak signifikan dalam kasus ini dan harus diabaikan.

pformatetcOut: FORMATETC

Ketika metode ini kembali, berisi penunjuk ke FORMATETC struktur yang berisi informasi paling umum yang mungkin untuk penyajian tertentu, membuatnya secara kanonis setara dengan formatetcIn. Pemanggil harus mengalokasikan struktur ini dan GetCanonicalFormatEtc(FORMATETC, FORMATETC) metode harus mengisi data. Untuk mengambil data dalam panggilan berikutnya seperti GetData(FORMATETC, STGMEDIUM), pemanggil menggunakan nilai yang disediakan , formatOutkecuali nilai yang disediakan adalah null. Nilai ini adalah null jika metode mengembalikan DATA_S_SAMEFORMATETC. Anggota TYMED tidak signifikan dalam kasus ini dan harus diabaikan. Parameter ini diteruskan tanpa diinisialisasi.

Mengembalikan

Int32

Metode ini mendukung nilai pengembalian standar E_INVALIDARG, E_UNEXPECTED, dan E_OUTOFMEMORY, serta berikut ini:

Nilai	Deskripsi
S_OK	Struktur yang dikembalikan FORMATETC berbeda dari struktur yang diteruskan.
DATA_S_SAMEFORMATETC	Strukturnya FORMATETC sama dan `null` dikembalikan dalam `formatOut` parameter .
DV_E_LINDEX	Ada nilai yang tidak valid untuk lindex; saat ini, hanya -1 yang didukung.
DV_E_FORMATETC	Ada nilai yang tidak valid untuk `pFormatetc` parameter .
OLE_E_NOTRUNNING	Aplikasi tidak berjalan.

Penerapan

GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Keterangan

Anggota ini adalah implementasi anggota antarmuka eksplisit. Ini hanya dapat digunakan ketika dilemparkan DataObject ke IDataObject antarmuka.

Berlaku untuk

Bagikan melalui