DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Metoda
Definicja
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 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ń.
- 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 .