DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

在数据对象和通知接收器之间创建连接。 此方法由对象进行调用，该对象支持通知接收器并使通知接收器能收到有关对象数据中的更改的通知。

 virtual int System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ pAdvSink, [Runtime::InteropServices::Out] int % pdwConnection) = System::Runtime::InteropServices::ComTypes::IDataObject::DAdvise;

int IDataObject.DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink pAdvSink, out int pdwConnection);

abstract member System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int
override this.System.Runtime.InteropServices.ComTypes.IDataObject.DAdvise : FORMATETC * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink * int -> int

Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, pAdvSink As IAdviseSink, ByRef pdwConnection As Integer) As Integer Implements IDataObject.DAdvise

参数

pFormatetc

FORMATETC

由引用传递的 FORMATETC 结构，它定义以后的通知将使用的格式、目标设备、方面和介质。

advf

ADVF

一个 ADVF 值，它指定用于控制通知连接的一组标志。

pAdvSink

IAdviseSink

指向将接收更改通知的通知接收器上的 IAdviseSink 接口的指针。

pdwConnection

Int32

此方法返回时，包含指向标识此连接的 DWORD 标记的指针。 以后可以使用此标记来删除通知连接，方法是将该标记发送至 DUnadvise(Int32)。 如果此值为零，则未建立连接。 此参数未经初始化即被传递。

返回

Int32

此方法支持 E_INVALIDARG、E_UNEXPECTED 和 E_OUTOFMEMORY 等标准返回值，以及下面的值：

值	说明
S_OK	已创建通知连接。
E_NOTIMPL	此方法未在数据对象上实现。
DV_E_LINDEX	lindex 有一个无效值；当前，只支持 -1。
DV_E_FORMATETC	pFormatetc 参数有一个无效值。
OLE_E_ADVISENOTSUPPORTED	该数据对象不支持更改通知。

实现

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

注解

此成员是显式接口成员的实现。 它只能在 DataObject 被强制转换为 IDataObject 接口时使用。