DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Mantıksal olarak daha karmaşık bir yapıya eşdeğer standart FORMATETC bir yapı sağlar. Yinelenen işleme gereksinimini ortadan kaldırarak iki farklı FORMATETC yapının aynı verileri döndürip döndürmeyeceğini belirlemek için bu yöntemi kullanın.

 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

Parametreler

pformatetcIn

FORMATETC

Çağıranın gibi GetData(FORMATETC, STGMEDIUM)sonraki bir FORMATETC çağrıdaki verileri almak için kullanmak istediğiniz biçimi, ortayı ve hedef cihazı tanımlayan, başvuru ile geçirilen bir yapı işaretçisi. Bu TYMED durumda üye önemli değildir ve yoksayılmalıdır.

pformatetcOut

FORMATETC

Bu yöntem döndürdüğünde, belirli bir işleme için mümkün olan en genel bilgileri içeren bir FORMATETC yapıya yönelik bir işaretçi içerir ve bunu eş anlamlı olarak ile formatetcIneşdeğer hale getirir. Çağıranın bu yapıyı ayırması ve yönteminin GetCanonicalFormatEtc(FORMATETC, FORMATETC) verileri doldurması gerekir. gibi GetData(FORMATETC, STGMEDIUM)sonraki bir çağrıdaki verileri almak için, sağlanan nulldeğer sağlanmadığı sürece çağıran tarafından sağlanan değerini formatOutkullanır. Bu değer, yöntemi döndürürse DATA_S_SAMEFORMATETColurnull. Bu TYMED durumda üye önemli değildir ve yoksayılmalıdır. Bu parametre, başlatmadan iletilir.

Döndürülenler

Int32

Bu yöntem E_INVALIDARG, E_UNEXPECTED ve E_OUTOFMEMORY standart dönüş değerlerini ve aşağıdakileri destekler:

Değer	Açıklama
S_OK	Döndürülen FORMATETC yapı, geçirilen yapıdan farklıdır.
DATA_S_SAMEFORMATETC	Yapılar FORMATETC aynıdır ve null parametresinde formatOut döndürülür.
DV_E_LINDEX	için lindexgeçersiz bir değer var; şu anda yalnızca -1 desteklenmektedir.
DV_E_FORMATETC	parametresi için pFormatetc geçersiz bir değer var.
OLE_E_NOTRUNNING	Uygulama çalışmıyor.

Uygulamalar

GetCanonicalFormatEtc(FORMATETC, FORMATETC)

Açıklamalar

Bu üye, açık bir arabirim üyesi uygulamasıdır. Yalnızca bir arabirime DataObjectIDataObject yayınlandığında kullanılabilir.