Condividi tramite


ClipboardObject.IDataObject.DAdvise Metodo

Definizione

Crea una connessione tra l'oggetto Appunti 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 ^ adviseSink, [Runtime::InteropServices::Out] int % connection) = 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 adviseSink, out int connection);
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, adviseSink As IAdviseSink, ByRef connection 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

Valore dell'enumerazione ADVF che specifica un gruppo di flag per il controllo della connessione consultiva.

adviseSink
IAdviseSink

Oggetto IAdviseSink che punta al sink consultivo che riceverà la notifica di modifica.

connection
Int32

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

Restituisce

Questo metodo supporta i valori restituiti standard E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, nonché i seguenti: ValueDescriptionS_OKThe connessione consultiva è stata creata. E_NOTIMPLThis metodo non viene implementato nei dati object.DV_E_LINDEXThere è un valore non valido per lindex; attualmente solo -1 è supported.DV_E_FORMATETCThere è un valore non valido per il pFormatetc parametro . OLE_E_ADVISENOTSUPPORTEDThe oggetto dati non supporta la notifica delle modifiche.

Implementazioni

Si applica a