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

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.InteropServices.ComTypes

Zestaw:: System.Runtime.InteropServices.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

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

Int32

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