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

Riferimento

Definizione

Spazio dei nomi:: System.Runtime.InteropServices.ComTypes

Assembly:: System.Runtime.InteropServices.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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.

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

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.

adviseSink: IAdviseSink

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

connection: 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.

Commenti

Per altre informazioni, vedere Metodo IDataObject::D Advise.

Si applica a