ClipboardObject.IDataObject.GetCanonicalFormatEtc 方法
提供標準的 FORMATETC 結構，這個結構在邏輯上相當於更複雜的結構。 使用這個方法會判斷兩個 FORMATETC 結構是否傳回相同的資料，而不需要重複呈現。
命名空間： Microsoft.VisualStudio.Data.Framework
組件： Microsoft.VisualStudio.Data.Framework (在 Microsoft.VisualStudio.Data.Framework.dll 中)
語法
'宣告
Private Function GetCanonicalFormatEtc ( _
ByRef formatIn As FORMATETC, _
<OutAttribute> ByRef formatOut As FORMATETC _
) As Integer Implements IDataObject.GetCanonicalFormatEtc
int IDataObject.GetCanonicalFormatEtc(
ref FORMATETC formatIn,
out FORMATETC formatOut
)
private:
virtual int GetCanonicalFormatEtc(
FORMATETC% formatIn,
[OutAttribute] FORMATETC% formatOut
) sealed = IDataObject::GetCanonicalFormatEtc
private abstract GetCanonicalFormatEtc :
formatIn:FORMATETC byref *
formatOut:FORMATETC byref -> int
private override GetCanonicalFormatEtc :
formatIn:FORMATETC byref *
formatOut:FORMATETC byref -> int
JScript 不支援明確介面實作。
參數
formatIn
類型：FORMATETC%in FORMATETC 結構的參考，以傳址方式傳遞的，定義格式、媒體和目標裝置呼叫端要用來擷取在後續的資料，例如 IDataObject.GetData。 tymed 成員在這種情況下並不重要，可以略過。
formatOut
類型：FORMATETC%當這個方法傳回時，這個參數會包含可能適用的最普遍資訊特定轉換的 FORMATETC 結構的指標，使它在標準上相當於 pformatectIn。 呼叫端必須配置這個結構，， GetCanonicalFormatEtc 方法必須填入資料。 擷取在後續的資料，例如 IDataObject.GetData，呼叫端會使用 pformatetcOut的提供值，，除非提供值為 nullnull 參考 (即 Visual Basic 中的 Nothing)。 如果方法傳回 DATA_S_SAMEFORMATETC，這個值為 null。 tymed 成員在這種情況下並不重要，可以略過。 這個參數會以未初始化的狀態傳遞。
傳回值
類型：Int32
這個方法支援標準傳回值 E_INVALIDARG、 E_UNEXPECTED和 E_OUTOFMEMORY，以及下列值:
值 |
Description |
|---|---|
S_OK |
傳回的 FORMATETC 結構與傳遞的結構不同。 |
DATA_S_SAMEFORMATETC |
FORMATETC 結構相同，且此參考傳回在 formatOut 參數。 |
DV_E_LINDEX |
lindex 有一個無效的值；目前只支援 -1。 |
DV_E_FORMATETC |
formatIn 參數有一個無效的值。 |
OLE_E_NOTRUNNING |
沒有執行應用程式。 |
實作
IDataObject.GetCanonicalFormatEtc(FORMATETC, FORMATETC)
備註
這個方法將呼叫委派給從 System.Runtime.InteropServices.ComTypes 命名空間中的對應 GetCanonicalFormatEtc ，假設， Clipboard 物件包裝現有的 IDataObject。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。