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

定義

名前空間:

System.Runtime.InteropServices.ComTypes

アセンブリ:

System.Runtime.InteropServices.dll

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

public:
 int DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ adviseSink, [Runtime::InteropServices::Out] int % connection);

public int DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink adviseSink, out int connection);

abstract member DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int

Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

パラメーター

pFormatetc

FORMATETC

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

advf

ADVF

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

adviseSink

IAdviseSink

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

connection

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	データ オブジェクトは、変更通知をサポートしていません。

注釈

詳細については、「 IDataObject::D Advise メソッド」を参照してください。