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 的指標。

若 GetCanonicalFormatEtc 方法傳回 DATA_S_SAMEFORMATETC，則為 FORMATETC 的輸出指標，其包含可能適用於特定呈現或 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 Management Console (MMC) 進行程式設計的詳細資訊，請參閱 MMC 程式設計人員指南。