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.
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 -> intPublic Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As IntegerParametri
- 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.
- adviseSink
- IAdviseSink
Puntatore all'interfaccia IAdviseSink nel sink di avviso che riceverà la notifica di modifica.
- connection
- 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. |
Commenti
Per altre informazioni, vedere Metodo IDataObject::D Advise.
