Language

IDataObject.GetCanonicalFormatEtc(IntPtr, IntPtr) メソッド

定義

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

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

パラメーター

a
IntPtr

nativeint

データを取得する呼び出しの形式、中、およびターゲット デバイスを定義する FORMATETC へのポインター。

b
IntPtr

nativeint

特定のレンダリングに使用できる最も一般的な情報を含む FORMATETC への出力ポインター。GetCanonicalFormatEtc メソッドがDATA_S_SAMEFORMATETCを返す場合に null 。

返品

GetCanonicalFormatEtc メソッドは、標準の戻り値E_INVALIDARG、E_UNEXPECTED、およびE_OUTOFMEMORY、および次の戻り値をサポートしています。

戻り値 Description
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 プログラマー ズ ガイドを参照してください。

適用対象