DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) 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 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 -> intFunction DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, pAdvSink As IAdviseSink, ByRef pdwConnection As Integer) As Integer Implements IDataObject.DAdvisePará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
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
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.
