Compartir a través de


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

Definición

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.

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 -> int
Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

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.

adviseSink
IAdviseSink

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

connection
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

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.

Comentarios

Para obtener más información, vea IDataObject::D MétodoAdvise.

Se aplica a