IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) Methode

Definitie

Naamruimte:
System.Runtime.InteropServices.ComTypes
Assembly's:
netstandard.dll, System.Runtime.InteropServices.dll
Assembly:
System.Runtime.InteropServices.dll
Assembly:
System.dll
Assembly:
netstandard.dll
Bron:
IDataObject.cs
Bron:
IDataObject.cs
Bron:
HandleCollector.cs

Biedt een standaardstructuur FORMATETC die logisch gelijk is aan een complexere structuur. Gebruik deze methode om te bepalen of twee verschillende FORMATETC structuren dezelfde gegevens retourneren, waardoor dubbele rendering niet meer nodig is.

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

Parameters

formatIn
FORMATETC

Een aanwijzer naar een FORMATETC structuur, doorgegeven door verwijzing, die de indeling, het medium en het doelapparaat definieert dat de beller wil gebruiken om gegevens op te halen in een volgende aanroep, zoals GetData(FORMATETC, STGMEDIUM). Het TYMED lid is in dit geval niet significant en moet worden genegeerd.

formatOut
FORMATETC

Wanneer deze methode wordt geretourneerd, bevat een aanwijzer naar een FORMATETC structuur die de meest algemene informatie bevat die mogelijk is voor een specifieke rendering, waardoor deze canoniek gelijk is aan formatetcIn. De aanroeper moet deze structuur toewijzen en de GetCanonicalFormatEtc(FORMATETC, FORMATETC) methode moet de gegevens invullen. Voor het ophalen van gegevens in een volgende aanroep, zoals GetData(FORMATETC, STGMEDIUM), gebruikt de aanroeper de opgegeven waarde , formatOuttenzij de opgegeven waarde is null. Deze waarde is null als de methode als resultaat geeft DATA_S_SAMEFORMATETC. Het TYMED lid is in dit geval niet significant en moet worden genegeerd. Deze parameter wordt niet-geïnitialiseerd doorgegeven.

Retouren

Int32

Deze methode ondersteunt de standaard retourwaarden E_INVALIDARG, E_UNEXPECTED en E_OUTOFMEMORY, evenals de volgende:

Waarde Beschrijving
S_OK De geretourneerde FORMATETC structuur verschilt van de structuur die is doorgegeven.
DATA_S_SAMEFORMATETC De FORMATETC structuren zijn hetzelfde en null worden geretourneerd in de formatOut parameter.
DV_E_LINDEX Er is een ongeldige waarde voor lindex; momenteel wordt alleen -1 ondersteund.
DV_E_FORMATETC Er is een ongeldige waarde voor de formatIn parameter.
OLE_E_NOTRUNNING De toepassing wordt niet uitgevoerd.

Opmerkingen

Zie de methode IDataObject::GetCanonicalFormatEtc voor meer informatie.

Van toepassing op