DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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í.