DataObject.IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC) 方法

定义

命名空间:
System.Windows
程序集:
PresentationCore.dll

提供逻辑上等效于更复杂的结构的标准 FORMATETC 结构。 使用此方法可确定两个不同的 FORMATETC 结构是否会返回相同的数据，从而不需要重复呈现。

 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

参数

pformatetcIn
FORMATETC

指向通过引用传递的结构的指针 FORMATETC ，用于定义调用方希望用于在后续调用中检索数据的格式、介质和目标设备，例如 GetData(FORMATETC, STGMEDIUM)。 在这种情况下，该 TYMED 成员并不重要，应忽略。

pformatetcOut
FORMATETC

此方法返回时，包含指向 FORMATETC 结构指针，该结构包含特定呈现可能的最通用信息，使其在音调上等效 formatetcIn。 调用方必须分配此结构，并且 GetCanonicalFormatEtc(FORMATETC, FORMATETC) 方法必须填充数据。 若要在后续调用（例如 GetData(FORMATETC, STGMEDIUM)）中检索数据，调用方将使用所提供的值 formatOut，除非提供的值是 null。 如果方法返回 ，则此值为 > 。 在这种情况下，该 TYMED 成员并不重要，应忽略。 此参数未初始化传递。

返回

Int32

此方法支持标准返回值E_INVALIDARG、E_UNEXPECTED和E_OUTOFMEMORY，以及以下内容：

值 说明
S_OK 返回 FORMATETC 的结构不同于传递的结构。
DATA_S_SAMEFORMATETC 结构 FORMATETC 相同， null 并在参数中 pformatetcOut 返回。
DV_E_LINDEX 存在无效值 lindex;目前仅支持 -1。
DV_E_FORMATETC 参数的值 pformatetcIn 无效。
OLE_E_NOTRUNNING 应用程序未运行。

实现

GetCanonicalFormatEtc(FORMATETC, FORMATETC)
属性
SecurityCriticalAttribute

注解

此成员是显式接口成员实现。 仅当实例强制转换为DataObject接口时IDataObject，才能使用它。

适用于