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.
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 -> intPublic Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As IntegerPará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.
