IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Yöntem

Tanım

Veri nesnesi ile danışmanlık havuzu arasında bir bağlantı oluşturur. Bu yöntem, bir danışmanlık havuzu destekleyen bir nesne tarafından çağrılır ve öneri havuzuna nesnenin verilerindeki değişikliklerle ilgili bildirim verilmesini sağlar.

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

Parametreler

pFormatetc
FORMATETC

FORMATETC Gelecek bildirimler için kullanılacak biçimi, hedef cihazı, yönü ve ortamı tanımlayan, başvuru ile geçirilen bir yapı.

advf
ADVF

ADVF Danışmanlık bağlantısını denetlemek için bir grup bayrak belirten değerlerden biri.

adviseSink
IAdviseSink

Değişiklik bildirimini IAdviseSink alacak öneri havuzundaki arabirimin işaretçisi.

connection
Int32

Bu yöntem döndürdüğünde, bu bağlantıyı tanımlayan bir DWORD belirtecinin işaretçisini içerir. Bu belirteci daha sonra kullanarak danışmanlık bağlantısını öğesine DUnadvise(Int32)geçirerek silebilirsiniz. Bu değer sıfırsa, bağlantı kurulmadı. Bu parametre, başlatmadan iletilir.

Döndürülenler

Bu yöntem E_INVALIDARG, E_UNEXPECTED ve E_OUTOFMEMORY standart dönüş değerlerini ve aşağıdakileri destekler:

Değer Açıklama
S_OK Danışmanlık bağlantısı oluşturuldu.
E_NOTIMPL Bu yöntem veri nesnesine uygulanmaz.
DV_E_LINDEX için lindexgeçersiz bir değer var; şu anda yalnızca -1 desteklenmektedir.
DV_E_FORMATETC parametresi için pFormatetc geçersiz bir değer var.
OLE_E_ADVISENOTSUPPORTED Veri nesnesi değişiklik bildirimini desteklemiyor.

Açıklamalar

Daha fazla bilgi için bkz. IDataObject::D Advise yöntemi.

Şunlara uygulanır