DataObject.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.

 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

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

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.

Si applica a