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

  • リファレンス

定義

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

適用対象