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

定義

命名空間:

System.Runtime.InteropServices.ComTypes

組件:

System.Runtime.InteropServices.dll

建立資料物件和通知接收之間的連接。 這個方法是由支援通知接收的物件所呼叫，且可以讓接收通知收到物件資料變更的通知。

public:
 int DAdvise(System::Runtime::InteropServices::ComTypes::FORMATETC % pFormatetc, System::Runtime::InteropServices::ComTypes::ADVF advf, System::Runtime::InteropServices::ComTypes::IAdviseSink ^ adviseSink, [Runtime::InteropServices::Out] int % connection);

public int DAdvise (ref System.Runtime.InteropServices.ComTypes.FORMATETC pFormatetc, System.Runtime.InteropServices.ComTypes.ADVF advf, System.Runtime.InteropServices.ComTypes.IAdviseSink adviseSink, out int connection);

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

Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

參數

pFormatetc

FORMATETC

以傳址方式傳遞的 FORMATETC 結構，定義用於後續告知的格式、目標裝置、外觀和媒體。

advf

ADVF

其中一個 ADVF 值，指定用於控制諮詢連接的一組旗標。

adviseSink

IAdviseSink

IAdviseSink 介面的指標，該介面位於接收變更告知的通知接收上。

connection

Int32

當這個方法傳回時，會包含識別這個連接的 DWORD 語彙基元 (Token) 的指標。 您可以在稍後將這個語彙基元傳遞到 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	資料物件不支援變更告知。

備註

如需詳細資訊，請參閱 IDataObject：:D Advise 方法。