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 インターフェイスにキャストされた場合にのみ使用できます。