ClipboardObject.IDataObject.DAdvise 方法
建立 Clipboard 物件和通知接收之間的連接。 這個方法是由支援通知接收的物件所呼叫，而且可以讓接收通知收到物件資料變更的通知。
命名空間： 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
類型：FORMATETC%以傳址 (By Reference) 方式傳遞的 FORMATETC 結構，定義用於後續告知的格式、目標裝置、外觀和媒體。
advf
類型：ADVF從為控制諮詢連接的旗標群組的 ADVF 列舉型別的值。
adviseSink
類型：IAdviseSink每個 IAdviseSink 中的物件會將接收變更告知的通知接收上。
connection
類型：Int32%Out 參數。 當這個方法傳回時，這個參數會包含識別這個連接的語彙基元。 您可以在稍後將這個語彙基元傳遞到 IDataObject.DUnadvise，以便用它來刪除諮詢連接。 如果這個值是零，就不會建立連接。 這個參數會以未初始化的狀態傳遞。
傳回值
類型：Int32
這個方法支援標準傳回值 E_INVALIDARG、 E_UNEXPECTED和 E_OUTOFMEMORY，以及下列值:
值 |
Description |
|---|---|
S_OK |
已建立諮詢連接。 |
E_NOTIMPL |
沒有在資料物件上實作這個方法。 |
DV_E_LINDEX |
取得 lindex的值無效;只有 -1 目前支援。 |
DV_E_FORMATETC |
pFormatetc 參數有一個無效的值。 |
OLE_E_ADVISENOTSUPPORTED |
資料物件不支援變更告知。 |
實作
IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)
備註
這個方法將呼叫委派給從 System.Runtime.InteropServices.ComTypes 命名空間中的對應 DAdvise ，假設， Clipboard 物件包裝現有的 IDataObject。
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊，請參閱從部分受信任程式碼使用程式庫。