IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices.ComTypes

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.InteropServices.dll

Kaynak:

IDataObject.cs

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.

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

Parametreler

formatIn

FORMATETC

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

formatOut

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 genel olarak ile eşdeğer hale getirir formatetcIn. Ç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 formatOutdeğer olmadığı sürece çağıran tarafından sağlanan değerini nullkullanır. Bu değer, yöntemi döndürürse nullolurDATA_S_SAMEFORMATETC. Üye TYMED bu durumda önemli değildir ve yoksayılmalıdır. Bu parametre başlatılmamış olarak geçirilir.

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 vardır; şu anda yalnızca -1 desteklenir.
DV_E_FORMATETC	parametresi için formatIn geçersiz bir değer var.
OLE_E_NOTRUNNING	Uygulama çalışmıyor.

Açıklamalar

Daha fazla bilgi için bkz. IDataObject::GetCanonicalFormatEtc yöntemi.