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

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Crea una conexión entre un objeto de datos y un receptor de aviso. Un objeto llama a este método que admite un receptor de asesoramiento y permite que el receptor de asesoramiento reciba una notificación de los cambios 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, el dispositivo de destino, el aspecto y el medio que se usarán para futuras notificaciones.

advf

ADVF

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

pAdvSink

IAdviseSink

Puntero a la IAdviseSink interfaz del receptor de aviso que recibirá la notificación de cambio.

pdwConnection

Int32

Cuando este método devuelve, contiene un puntero a un token DWORD que identifica esta conexión. Puede usar este token más adelante para eliminar la conexión de asesoramiento pasandolo a DUnadvise(Int32). Si este valor es cero, 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 lo siguiente:

Valor	Descripción
S_OK	Se creó la conexión de asesoramiento.
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, solo se admite -1.
DV_E_FORMATETC	Hay un valor no válido para el pFormatetc parámetro .
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 miembro de interfaz. Solo se puede usar cuando se convierte en DataObject una IDataObject interfaz.