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
    类型: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 安全性

请参阅

参考

ClipboardObject 类

Microsoft.VisualStudio.Data.Framework 命名空间