剪贴板创建对象和一个包含建议、接收器之间的连接。 此方法由对象进行调用,该对象支持通知接收器并使通知接收器能收到有关对象数据中的更改的通知。
命名空间: 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%由引用传递的 FORMATETC 结构,它定义以后的通知将使用的格式、目标设备、方面和介质。
advf
类型:ADVF从为控制包含建议性指定连接一组标志的 ADVF 枚举的值。
adviseSink
类型:IAdviseSink指向一 IAdviseSink 对象到接收通知的更改包含建议、接收器。
connection
类型:Int32%Out 参数。 当此方法返回时,此参数中包含标识此连接的标记。 以后可以使用此标记来删除通知连接,方法是将该标记发送至 IDataObject.DUnadvise。 如果此值为零,则未建立连接。 该参数未经初始化即被传递。
返回值
类型: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)
备注
此方法将调用。从 System.Runtime.InteropServices.ComTypes 命名空间对应的 DAdvise,前提,剪贴板对象包装现有 IDataObject。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关详细信息,请参阅通过部分受信任的代码使用库。