ClipboardObject.IDataObject.DAdvise メソッド
クリップボードのオブジェクトとアドバイズ シンク間の接続を作成します。このメソッドは、アドバイズ シンクをサポートするオブジェクトによって呼び出され、オブジェクトのデータの変更をアドバイズ シンクに通知できるようにします。
名前空間: Microsoft.VisualStudio.Data.Framework
アセンブリ: Microsoft.VisualStudio.Data.Framework (Microsoft.VisualStudio.Data.Framework.dll 内)
構文
'宣言
Private Function DAdvise ( _
ByRef pFormatetc As FORMATETC, _
advf As ADVF, _
adviseSink As IAdviseSink, _
<OutAttribute> ByRef connection As Integer _
) As Integer Implements IDataObject.DAdvise
int IDataObject.DAdvise(
ref FORMATETC pFormatetc,
ADVF advf,
IAdviseSink adviseSink,
out int connection
)
private:
virtual int DAdvise(
FORMATETC% pFormatetc,
ADVF advf,
IAdviseSink^ adviseSink,
[OutAttribute] int% connection
) sealed = IDataObject::DAdvise
private abstract DAdvise :
pFormatetc:FORMATETC byref *
advf:ADVF *
adviseSink:IAdviseSink *
connection:int byref -> int
private override DAdvise :
pFormatetc:FORMATETC byref *
advf:ADVF *
adviseSink:IAdviseSink *
connection:int byref -> int
JScript では、明示的なインターフェイスの実装はサポートされません。
パラメーター
- pFormatetc
型 : System.Runtime.InteropServices.ComTypes.FORMATETC%
今後の通知のために使用される形式、対象デバイス、特性、およびメディアを定義する FORMATETC 構造体 (参照渡し)。
- advf
型 : System.Runtime.InteropServices.ComTypes.ADVF
アドバイザリ コネクションを制御するフラグのグループを指定する ADVF の列挙体の値。
- adviseSink
型 : System.Runtime.InteropServices.ComTypes.IAdviseSink
指す変更通知を受け取るアドバイズ シンクに IAdviseSink のオブジェクト。
- connection
型 : System.Int32%
Out パラメーター。このメソッドが返されるとき、このパラメーターにこの接続を識別するトークンが含まれています。このトークンを後で IDataObject.DUnadvise に渡して、アドバイザリ コネクションを削除できます。この値が 0 の場合、接続は確立されていません。このパラメーターは初期化せずに渡されます。
戻り値
型 : System.Int32
このメソッドは、標準の戻り値 E_INVALIDARG、E_UNEXPECTEDと E_OUTOFMEMORY、次をサポートします:
値 |
説明 |
|---|---|
S_OK |
アドバイザリ コネクションが作成されました。 |
E_NOTIMPL |
このメソッドは、データ オブジェクトには実装されていません。 |
DV_E_LINDEX |
lindex に対して無効な値があります。; 現在 -1 のみがサポートされます。 |
DV_E_FORMATETC |
pFormatetc パラメーターに無効な値があります。 |
OLE_E_ADVISENOTSUPPORTED |
データ オブジェクトは、変更通知をサポートしていません。 |
実装
IDataObject.DAdvise(FORMATETC%, ADVF, IAdviseSink, Int32%)
解説
このメソッドは、クリップボードのオブジェクトが既存の IDataObjectをラップしていると仮定する System.Runtime.InteropServices.ComTypes の名前空間からの対応する DAdvise の呼び出しに委任します。
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。