Udostępnij za pośrednictwem


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

Definicja

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

 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

Parametry

pFormatetc
FORMATETC

FORMATETC Struktura 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.

pAdvSink
IAdviseSink

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

pdwConnection
Int32

Gdy ta metoda zostanie zwrócona, zawiera wskaźnik do tokenu DWORD, który identyfikuje to połączenie. Możesz później użyć tego tokenu, aby usunąć połączenie z poradami, przekazując je do DUnadvise(Int32)usługi . Jeśli ta wartość ma wartość 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 Dla parametru jest nieprawidłowa wartość lindex; obecnie obsługiwana jest tylko wartość -1.
DV_E_FORMATETC Dla parametru istnieje nieprawidłowa pFormatetc wartość.
OLE_E_ADVISENOTSUPPORTED Obiekt danych nie obsługuje powiadomienia o zmianie.

Implementuje

Uwagi

Ten element jest jawną implementacją członków. Można go używać tylko wtedy, gdy DataObject element jest rzutowy do interfejsu IDataObject .

Dotyczy