IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Yöntem

Tanım

Ad Alanı:

System.Runtime.InteropServices.ComTypes

Bütünleştirilmiş Kod:

System.Runtime.InteropServices.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.

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 GetData(FORMATETC, STGMEDIUM)sonraki bir FORMATETC çağrıda verileri almak için kullanmak istediğiniz biçimi, ortayı ve hedef cihazı tanımlayan, başvuruyla geçirilen bir yapı işaretçisi. Bu TYMED durumda üye ö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ı işaretçisi içerir ve bu da onu genel 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 olmadığı sürece çağıran tarafından sağlanan değerini formatOutkullanır. Bu değer, yönteminin döndürdüğü DATA_S_SAMEFORMATETCdeğerdirnull. 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ğerlerinin yanı sıra 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.

Açıklamalar

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