DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Metodo
Definizione
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 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 .