IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Method

Definizione

Crea una connessione tra un oggetto dati e un sink consultivo.Creates a connection between a data object and an advisory sink. Questo metodo viene chiamato da un oggetto che supporta un sink consultivo e attiva tale sink per ricevere una notifica delle modifiche nei dati dell'oggetto.This method is called by an object that supports an advisory sink and enables the advisory sink to be notified of changes in the object's data.

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 :  * System.Runtime.InteropServices.ComTypes.ADVF * System.Runtime.InteropServices.ComTypes.IAdviseSink *  -> int

Parametri

pFormatetc
FORMATETC FORMATETC FORMATETC

Struttura FORMATETC, passata per riferimento, che definisce formato, periferica di destinazione, aspetto e supporto che verranno utilizzati per notifiche future.A FORMATETC structure, passed by reference, that defines the format, target device, aspect, and medium that will be used for future notifications.

advf
ADVF ADVF ADVF

Uno dei valori di ADVF che specifica un gruppo di flag per il controllo della connessione consultiva.One of the ADVF values that specifies a group of flags for controlling the advisory connection.

adviseSink
IAdviseSink IAdviseSink IAdviseSink

Puntatore all'interfaccia IAdviseSink nel sink consultivo che riceverà la notifica della modifica.A pointer to the IAdviseSink interface on the advisory sink that will receive the change notification.

connection
Int32 Int32 Int32

Quando termina, il metodo contiene un puntatore a un token DWORD che identifica la connessione.When this method returns, contains a pointer to a DWORD token that identifies this connection. È possibile utilizzare questo token in un secondo momento per eliminare la connessione consultiva passandolo al metodo DUnadvise(Int32).You can use this token later to delete the advisory connection by passing it to DUnadvise(Int32). Se il valore è zero, la connessione non è stata stabilita.If this value is zero, the connection was not established. Questo parametro viene passato non inizializzato.This parameter is passed uninitialized.

Restituisce

Questo metodo supporta i valori restituiti standard E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, nonché quanto segue:This method supports the standard return values E_INVALIDARG, E_UNEXPECTED, and E_OUTOFMEMORY, as well as the following:

ValueValue DescrizioneDescription
S_OKS_OK La connessione consultiva è stata creata.The advisory connection was created.

E_NOTIMPLE_NOTIMPL Questo metodo non è implementato nell'oggetto dati.This method is not implemented on the data object.

DV_E_LINDEXDV_E_LINDEX È presente un valore non valido per lindex; attualmente, è supportato solo il valore -1.There is an invalid value for lindex; currently, only -1 is supported.

DV_E_FORMATETCDV_E_FORMATETC È presente un valore non valido per il parametro pFormatetc.There is an invalid value for the pFormatetc parameter.

OLE_E_ADVISENOTSUPPORTEDOLE_E_ADVISENOTSUPPORTED L'oggetto dati non supporta la notifica delle modifiche.The data object does not support change notification.

Commenti

Per altre informazioni sulle IDataObject::DAdvise, consultare la MSDN Library.For more information about IDataObject::DAdvise, see the MSDN Library.

Si applica a