IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Metode

Referensi

Definisi

Ruang nama:: System.Runtime.InteropServices.ComTypes

Rakitan:: System.Runtime.InteropServices.dll

Rakitan:: System.dll

Rakitan:: netstandard.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.

public:
 int GetCanonicalFormatEtc(System::Runtime::InteropServices::ComTypes::FORMATETC % formatIn, [Runtime::InteropServices::Out] System::Runtime::InteropServices::ComTypes::FORMATETC % formatOut);

public int GetCanonicalFormatEtc (ref System.Runtime.InteropServices.ComTypes.FORMATETC formatIn, out System.Runtime.InteropServices.ComTypes.FORMATETC formatOut);

abstract member GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int

Public Function GetCanonicalFormatEtc (ByRef formatIn As FORMATETC, ByRef formatOut As FORMATETC) As Integer

Parameter

formatIn: 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.

formatOut: 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.

Keterangan

Untuk informasi selengkapnya, lihat metode IDataObject::GetCanonicalFormatEtc.

Berlaku untuk

Bagikan melalui