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

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

DataObject.cs

Crea una connessione tra un oggetto dati e un sink consultivo. Questo metodo viene chiamato da un oggetto che supporta un sink consultivo e abilita tale sink per ricevere una notifica delle modifiche nei dati dell'oggetto.

 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

Parametri

pFormatetc

FORMATETC

Struttura FORMATETC, passata per riferimento, che definisce formato, periferica di destinazione, aspetto e supporto che verranno utilizzati per notifiche future.

advf

ADVF

Uno dei valori di ADVF che specifica un gruppo di flag per il controllo della connessione consultiva.

pAdvSink

IAdviseSink

Puntatore all'interfaccia IAdviseSink nel sink consultivo che riceverà la notifica della modifica.

pdwConnection

Int32

Quando termina, questo metodo contiene un puntatore a un token DWORD che identifica la connessione. È possibile utilizzare questo token in un secondo momento per eliminare la connessione consultiva passandolo al metodo DUnadvise(Int32). Se il valore è zero, la connessione non è stata stabilita. Questo parametro viene passato non inizializzato.

Restituisce

Int32

Questo metodo supporta i valori restituiti standard E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, nonché quanto segue:

Valore	Descrizione
S_OK	La connessione consultiva è stata creata.
E_NOTIMPL	Questo metodo non è implementato nell'oggetto dati.
DV_E_LINDEX	È presente un valore non valido per lindex; attualmente, è supportato solo il valore -1.
DV_E_FORMATETC	È presente un valore non valido per il parametro pFormatetc.
OLE_E_ADVISENOTSUPPORTED	L'oggetto dati non supporta la notifica delle modifiche.

Implementazioni

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Commenti

Questo membro è un’implementazione esplicita di un membro di interfaccia. Può essere utilizzato solo quando si esegue il cast della classe DataObject su un'interfaccia IDataObject.