ClipboardObject.IDataObject.DAdvise Método
Definición
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 el objeto del Portapapeles y un receptor de asesoramiento. 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 ^ adviseSink, [Runtime::InteropServices::Out] int % connection) = 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 adviseSink, out int connection);
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, adviseSink As IAdviseSink, ByRef connection 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
Valor de la ADVF enumeración que especifica un grupo de marcas para controlar la conexión de asesoramiento.
- adviseSink
- IAdviseSink
Objeto IAdviseSink que apunta al receptor de aviso que recibirá la notificación de cambio.
- connection
- Int32
Parámetro de salida. Cuando este método finaliza, este parámetro contiene un token que identifica esta conexión. Puede utilizar este símbolo (token) posteriormente para eliminar la conexión de consulta pasándolo a IDataObject.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 lo siguiente: se creó ValueDescriptionS_OKThe conexión de aviso. E_NOTIMPLThis método no se implementa en el object.DV_E_LINDEXThere de datos es un valor no válido para lindex; actualmente solo -1 es supported.DV_E_FORMATETCThere es un valor no válido para el pFormatetc
parámetro . OLE_E_ADVISENOTSUPPORTEDThe objeto de datos no admite la notificación de cambios.