IDataObject.GetCanonicalFormatEtcとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

IDataObject.GetCanonicalFormatEtc メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

a パラメータによって参照される FORMATETC 構造体と論理的に等価な (ただし、必ずしも等しくはない) 標準の FORMATETC 構造体へのポインタを取得します。

名前空間: Microsoft.Aspnet.Snapin
アセンブリ: AspNetMMCExt (aspnetmmcext.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As IDataObject
Dim a As IntPtr
Dim b As IntPtr
Dim returnValue As Integer

returnValue = instance.GetCanonicalFormatEtc(a, b)

int GetCanonicalFormatEtc (
    IntPtr a,
    IntPtr b
)

C++

int GetCanonicalFormatEtc (
    IntPtr a, 
    IntPtr b
)

int GetCanonicalFormatEtc (
    IntPtr a, 
    IntPtr b
)

JScript

function GetCanonicalFormatEtc (
    a : IntPtr, 
    b : IntPtr
) : int

パラメータ

a: データを取得するための呼び出しの形式、メディア、および対象デバイスを定義する FORMATETC へのポインタ。

b

特定の表示についての最も一般的な情報を格納している FORMATETC への出力ポインタ。

または

GetCanonicalFormatEtc メソッドが DATA_S_SAMEFORMATETC を返す場合は null 参照 (Visual Basic では Nothing)。

戻り値
GetCanonicalFormatEtc メソッドは、標準の戻り値である E_INVALIDARG、E_UNEXPECTED、および E_OUTOFMEMORY をサポートすると同時に、次の戻り値もサポートしています。

戻り値	説明
S_OK	返された FORMATETC は、パラメータで渡された構造体とは異なります。
DATA_S_SAMEFORMATETC	返された FORMATETC はパラメータで渡された構造体と同じであり、b で null 参照 (Visual Basic では Nothing) が返されました。
DV_E_LINDEX	lindex が有効ではありません。
DV_E_FORMATETC	a が有効ではありません。
OLE_E_NOTRUNNING	オブジェクトアプリケーションが実行されていません。

解説

GetCanonicalFormatEtc メソッドを使用すると、IDataObject インターフェイスの実装側で、FORMATETC 構造体の表示ロジックを複製せずに標準の FORMATETC 構造体を返すことができます。

IDataObject インターフェイスを使用したプログラミングおよび Microsoft 管理コンソール (MMC) の詳細については、MSDN ライブラリにある『MMC Programmer's Guide』を参照してください。

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IDataObject インターフェイス
IDataObject メンバ
Microsoft.Aspnet.Snapin 名前空間

IDataObject.GetCanonicalFormatEtc メソッド

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

名前空間: Microsoft.CLRAdmin
アセンブリ: mscorcfg (mscorcfg.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As IDataObject
Dim a As IntPtr
Dim b As IntPtr
Dim value As Integer

value = instance.GetCanonicalFormatEtc(a, b)

int GetCanonicalFormatEtc (
    IntPtr a,
    IntPtr b
)

C++

int GetCanonicalFormatEtc (
    IntPtr a, 
    IntPtr b
)

int GetCanonicalFormatEtc (
    IntPtr a, 
    IntPtr b
)

JScript

function GetCanonicalFormatEtc (
    a : IntPtr, 
    b : IntPtr
) : int

パラメータ

a

b

.NET Framework のセキュリティ

直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

バージョン情報

.NET Framework
サポート対象 : 1.1、1.0

参照

関連項目
IDataObject インターフェイス
IDataObject メンバ
Microsoft.CLRAdmin 名前空間

IDataObject.GetCanonicalFormatEtc メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

より複雑な構造体と論理的に等価な、標準の FORMATETC 構造体を提供します。このメソッドを使用して、2 つの異なる FORMATETC 構造体が同一のデータを返すかどうかを確認し、表示を二重化する必要をなくします。

名前空間: System.Runtime.InteropServices.ComTypes
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Function GetCanonicalFormatEtc ( _
    <InAttribute> ByRef formatIn As FORMATETC,
 _
    <OutAttribute> ByRef formatOut As
 FORMATETC _
) As Integer

Visual Basic (使用法)

Dim instance As IDataObject
Dim formatIn As FORMATETC
Dim formatOut As FORMATETC
Dim returnValue As Integer

returnValue = instance.GetCanonicalFormatEtc(formatIn, formatOut)

int GetCanonicalFormatEtc (
    [InAttribute] ref FORMATETC formatIn,
    out FORMATETC formatOut
)

C++

int GetCanonicalFormatEtc (
    [InAttribute] FORMATETC% formatIn, 
    [OutAttribute] FORMATETC% formatOut
)

int GetCanonicalFormatEtc (
    /** @attribute InAttribute() */ /** @ref */ FORMATETC formatIn, 
    /** @attribute OutAttribute() */ /** @ref */ FORMATETC formatOut
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

formatIn: GetData などの後続の呼び出しで、呼び出し元がデータを取得するために使用する必要がある、形式、メディア、および対象デバイスを定義する FORMATETC 構造体へのポインタ (参照渡し)。TYMED メンバは、この場合には重要ではないため、無視する必要があります。

formatOut: このメソッドから制御が戻るときに、特定の表示で最も一般的な情報を格納している FORMATETC 構造体へのポインタを格納し、formatetIn と規準的等価にします。呼び出し元でこの構造体を割り当て、GetCanonicalFormatEtc メソッドでデータを格納する必要があります。GetData などの後続の呼び出しでデータを取得するには、指定された値が null 参照 (Visual Basic では Nothing) の場合を除き、呼び出し元は formatOut に指定された値を使用します。このメソッドが DATA_S_SAMEFORMATETC を返す場合、この値は null 参照 (Visual Basic では Nothing) です。TYMED メンバは、この場合には重要ではないため、無視する必要があります。このパラメータは初期化せずに渡されます。

戻り値
このメソッドは、標準の戻り値である E_INVALIDARG、E_UNEXPECTED、および E_OUTOFMEMORY をサポートすると同時に、次の値もサポートしています。

値	説明
S_OK	返される FORMATETC 構造体は、渡された構造体とは異なります。
DATA_S_SAMEFORMATETC	複数の FORMATETC 構造体が同一で、formatOut パラメータに null 参照 (Visual Basic では Nothing) が返されます。
DV_E_LINDEX	lindex に無効な値があります。現在は -1 だけがサポートされています。
DV_E_FORMATETC	pFormatetc パラメータに無効な値があります。
OLE_E_NOTRUNNING	アプリケーションが実行されていません。