DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Método

Referencia

Definición

Espacio de nombres:: System.Windows.Forms

Ensamblado:: System.Windows.Forms.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Crea una conexión entre un objeto de datos y un receptor de consulta. Este método es invocado por un objeto que admite un receptor de consulta y permite que a dicho receptor se le notifiquen los cambios realizados en los datos del objeto.

 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

Parámetros

pFormatetc: FORMATETC

Estructura FORMATETC, pasada por referencia, que define el formato, dispositivo de destino, aspecto y medio que se utilizarán para las notificaciones futuras.

advf: ADVF

Uno de los valores de ADVF que especifica un grupo de marcadores para controlar la conexión de consulta.

pAdvSink: IAdviseSink

Puntero a la interfaz IAdviseSink en el receptor de consulta que recibirá la notificación de cambios.

pdwConnection: Int32

El resultado que devuelve este método contiene un puntero a un símbolo (token) de DWORD que identifica esta conexión. Puede utilizar este símbolo (token) posteriormente para eliminar la conexión de consulta pasándolo a DUnadvise(Int32). Si este valor es cero, indicará que no se estableció la conexión. Este parámetro se pasa sin inicializar.

Devoluciones

Int32

Este método admite los valores devueltos estándar E_INVALIDARG, E_UNEXPECTED y E_OUTOFMEMORY, así como los valores siguientes:

Valor	Descripción
S_OK	Se creó la conexión de consulta.
E_NOTIMPL	Este método no se implementa en el objeto de datos.
DV_E_LINDEX	Hay un valor no válido para lindex; actualmente, sólo se admite -1.
DV_E_FORMATETC	Hay un valor no válido para el parámetro `pFormatetc`.
OLE_E_ADVISENOTSUPPORTED	El objeto de datos no admite la notificación de cambios.

Implementaciones

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Comentarios

Este miembro es una implementación explícita de un miembro de interfaz. Sólo se puede usar cuando DataObject se convierte en una interfaz IDataObject.

Se aplica a

Compartir vía