IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) 方法

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

检索指向标准 FORMATETC 结构的指针，该结构在逻辑上等效于（但不一定等于）a 参数引用的 FORMATETC 结构。

public:
 int GetCanonicalFormatEtc(IntPtr a, IntPtr b);

public int GetCanonicalFormatEtc (IntPtr a, IntPtr b);

abstract member GetCanonicalFormatEtc : nativeint * nativeint -> int

Public Function GetCanonicalFormatEtc (a As IntPtr, b As IntPtr) As Integer

指向 FORMATETC 的指针，它为检索数据的调用定义格式、介质和目标设备。

一个指向 FORMATETC 的输出指针，它包含特定呈现可能使用的最常见信息；如果 GetCanonicalFormatEtc 方法返回 DATA_S_SAMEFORMATETC，则为 null。

Int32

GetCanonicalFormatEtc 方法支持 E_INVALIDARG、E_UNEXPECTED 和 E_OUTOFMEMORY 等标准返回值以及下面的返回值：

返回值	说明
S_OK	返回的 FORMATETC 不同于参数中传递的结构。
DATA_S_SAMEFORMATETC	返回的 FORMATETC 与参数中传递的结构相同，并在 `null` 中 `b`返回。
DV_E_LINDEX	lindex 无效。
DV_E_FORMATETC	`a` 无效。
OLE_E_NOTRUNNING	对象应用程序未运行。

GetCanonicalFormatEtc 方法允许接口的 IDataObject 实现者返回规范 FORMATETC 结构，而无需复制结构的 FORMATETC 呈现逻辑。

有关使用 IDataObject 接口和 Microsoft 管理控制台 (MMC) 进行编程的详细信息，请参阅 MMC 程序员指南。