Udostępnij za pośrednictwem


IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Metoda

Definicja

Tworzy połączenie między obiektem danych a ujściem poradnika. Ta metoda jest wywoływana przez obiekt, który obsługuje ujście porad i umożliwia ujście porady powiadamianie o zmianach w danych obiektu.

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

Parametry

pFormatetc
FORMATETC

Struktura FORMATETC przekazywana przez odwołanie, która definiuje format, urządzenie docelowe, aspekt i medium, które będą używane na potrzeby przyszłych powiadomień.

advf
ADVF

ADVF Jedna z wartości określających grupę flag do kontrolowania połączenia doradczego.

adviseSink
IAdviseSink

Wskaźnik do interfejsu ujścia IAdviseSink porady, który otrzyma powiadomienie o zmianie.

connection
Int32

Gdy ta metoda zwraca, zawiera wskaźnik do tokenu DWORD, który identyfikuje to połączenie. Tego tokenu można później użyć do usunięcia połączenia doradczego, przekazując go do elementu DUnadvise(Int32). Jeśli ta wartość jest równa zero, połączenie nie zostało nawiązane. Ten parametr jest przekazywany jako niezainicjowany.

Zwraca

Ta metoda obsługuje standardowe wartości zwracane E_INVALIDARG, E_UNEXPECTED i E_OUTOFMEMORY, a także następujące:

Wartość Opis
S_OK Utworzono połączenie z poradami.
E_NOTIMPL Ta metoda nie jest implementowana w obiekcie danych.
DV_E_LINDEX Istnieje nieprawidłowa wartość dla lindexparametru ; obecnie obsługiwana jest tylko wartość -1.
DV_E_FORMATETC Parametr ma nieprawidłową wartość pFormatetc .
OLE_E_ADVISENOTSUPPORTED Obiekt danych nie obsługuje powiadomienia o zmianie.

Uwagi

Aby uzyskać więcej informacji, zobacz IDataObject::D Advise, metoda.

Dotyczy