DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Metoda

Definice

Poskytuje standardní FORMATETC strukturu, která je logicky ekvivalentní složitější struktuře. Tuto metodu použijte k určení, jestli by dvě různé FORMATETC struktury vrátily stejná data, a proto je potřeba duplikovat vykreslová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;
[System.Security.SecurityCritical]
int IDataObject.GetCanonicalFormatEtc(ref System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcIn, out System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcOut);
int IDataObject.GetCanonicalFormatEtc(ref System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcIn, out System.Runtime.InteropServices.ComTypes.FORMATETC pformatetcOut);
[<System.Security.SecurityCritical>]
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.GetCanonicalFormatEtc : FORMATETC * FORMATETC -> int
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

Parametry

pformatetcIn
FORMATETC

Ukazatel na FORMATETC strukturu předanou odkazem, která definuje formát, střední a cílové zařízení, které volající chce použít k načtení dat v následném volání, například GetData(FORMATETC, STGMEDIUM). Člen TYMED v tomto případě není významný a měl by být ignorován.

pformatetcOut
FORMATETC

Pokud tato metoda vrátí, obsahuje ukazatel na FORMATETC strukturu, která obsahuje nejobecnější informace možné pro konkrétní vykreslování, takže je kanonicky ekvivalentní formatetcIn. Volající musí přidělit tuto strukturu a GetCanonicalFormatEtc(FORMATETC, FORMATETC) metoda musí vyplnit data. K načtení dat v následném volání, jako GetData(FORMATETC, STGMEDIUM)je , volající používá zadanou hodnotu formatOut, pokud není nullzadaná hodnota . Tato hodnota je null , pokud metoda vrátí DATA_S_SAMEFORMATETC. Člen TYMED v tomto případě není významný a měl by být ignorován. Tento parametr se předává neinicializovaný.

Návraty

Tato metoda podporuje standardní návratové hodnoty E_INVALIDARG, E_UNEXPECTED a E_OUTOFMEMORY a také následující:

Hodnota Popis
S_OK FORMATETC Vrácená struktura se liší od té, která byla předána.
DATA_S_SAMEFORMATETC Struktury FORMATETC jsou stejné a null vrátí se v parametru pformatetcOut .
DV_E_LINDEX Pro ; v současné době je lindexpodporována pouze -1.
DV_E_FORMATETC Parametr má neplatnou hodnotu pformatetcIn .
OLE_E_NOTRUNNING Aplikace není spuštěná.

Implementuje

Atributy

Poznámky

Tento člen je explicitní implementace člena rozhraní. Lze jej použít pouze v případě, DataObject že je instance přetypována do IDataObject rozhraní.

Platí pro