Condividi tramite


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

Definizione

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

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