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

Definizione

Crea una connessione tra un oggetto dati e un sink di avviso. Questo metodo viene chiamato da un oggetto che supporta un sink di consulenza e consente al sink di consulenza di 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 il formato, il dispositivo di destinazione, l'aspetto e il supporto che verranno usati per le notifiche future.

advf
ADVF

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

pAdvSink
IAdviseSink

Puntatore all'interfaccia IAdviseSink nel sink di avviso che riceverà la notifica di modifica.

pdwConnection
Int32

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

Valori restituiti

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

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

Implementazioni

Commenti

Questo membro è un'implementazione esplicita del membro dell'interfaccia. Può essere usato solo quando viene eseguito il cast di a un'interfaccia DataObjectIDataObject .

Si applica a