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

定義

名前空間:
System.Runtime.InteropServices.ComTypes
アセンブリ:
System.dll
アセンブリ:
netstandard.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 メソッド」を参照してください。

適用対象