Aracılığıyla paylaş


IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Yöntem

Tanım

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

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.

Şunlara uygulanır