DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) メソッド

  • リファレンス

定義

名前空間:
System.Windows.Forms
アセンブリ:
System.Windows.Forms.dll

データ オブジェクトとアドバイズ シンク間の接続を作成します。 このメソッドは、アドバイズ シンクをサポートするオブジェクトによって呼び出され、オブジェクトのデータの変更をアドバイズ シンクに通知できるようにします。

 virtual int System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ pAdvSink, [Runtime::InteropServices::Out] int % pdwConnection) = System::Runtime::InteropServices::ComTypes::IDataObject::DAdvise;
int IDataObject.DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink pAdvSink, out int pdwConnection);
abstract member System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, pAdvSink As IAdviseSink, ByRef pdwConnection As Integer) As Integer Implements IDataObject.DAdvise

パラメーター

pFormatetc
FORMATETC

今後の通知のために使用される形式、対象デバイス、特性、およびメディアを定義する FORMATETC 構造体 (参照渡し)。

advf
ADVF

アドバイザリ コネクションの制御用フラグのグループを指定する ADVF 値の 1 つ。

pAdvSink
IAdviseSink

変更通知を受信するアドバイズ シンク上の IAdviseSink インターフェイスへのポインター。

pdwConnection
Int32

このメソッドから制御が戻るときに、この接続を識別する DWORD トークンへのポインターを格納します。 このトークンを後で DUnadvise(Int32) に渡して、アドバイザリ コネクションを削除できます。 この値が 0 の場合、接続は確立されていません。 このパラメーターは初期化せずに渡されます。

戻り値

Int32

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

値 説明
S_OK アドバイザリ コネクションが作成されました。
E_NOTIMPL このメソッドは、データ オブジェクトには実装されていません。
DV_E_LINDEX lindex に無効な値があります。現在は -1 だけがサポートされています。
DV_E_FORMATETC pFormatetc パラメーターに無効な値があります。
OLE_E_ADVISENOTSUPPORTED データ オブジェクトは、変更通知をサポートしていません。

実装

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

注釈

このメンバーは、明示的なインターフェイス メンバーの実装です。 DataObject が IDataObject インターフェイスにキャストされた場合にのみ使用できます。

適用対象