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