创建剪贴板对象和一个具有建议性接收器之间的连接。此方法由对象进行调用,该对象支持通知接收器并使通知接收器能收到有关对象数据中的更改的通知。
命名空间: 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。如果此值为零,则未建立连接。该参数未经初始化即被传递。
返回值
类型: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%)
备注
此方法将调用委托给从 System.Runtime.InteropServices.ComTypes 命名空间的相应 DAdvise,假定,剪贴板对象包装现有 IDataObject。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。