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

Definición

Espacio de nombres:
System.Runtime.InteropServices.ComTypes
Ensamblado:
System.dll
Ensamblado:
netstandard.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.

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

adviseSink
IAdviseSink

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

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

Comentarios

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

Se aplica a