ClipboardObject.IDataObject.DAdvise (Método)

Crea una conexión entre el objeto del portapapeles y un receptor asesor.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.

Espacio de nombres:  Microsoft.VisualStudio.Data.Framework
Ensamblado:  Microsoft.VisualStudio.Data.Framework (en Microsoft.VisualStudio.Data.Framework.dll)

Sintaxis

'Declaración
Private Function DAdvise ( _
    ByRef pFormatetc As FORMATETC, _
    advf As ADVF, _
    adviseSink As IAdviseSink, _
    <OutAttribute> ByRef connection As Integer _
) As Integer Implements IDataObject.DAdvise

int IDataObject.DAdvise(
    ref FORMATETC pFormatetc,
    ADVF advf,
    IAdviseSink adviseSink,
    out int connection
)

private:
virtual int DAdvise(
    FORMATETC% pFormatetc, 
    ADVF advf, 
    IAdviseSink^ adviseSink, 
    [OutAttribute] int% connection
) sealed = IDataObject::DAdvise

private abstract DAdvise : 
        pFormatetc:FORMATETC byref * 
        advf:ADVF * 
        adviseSink:IAdviseSink * 
        connection:int byref -> int 
private override DAdvise : 
        pFormatetc:FORMATETC byref * 
        advf:ADVF * 
        adviseSink:IAdviseSink * 
        connection:int byref -> int 

JScript no admite implementaciones explícitas de interfaces.

Parámetros

• pFormatetc
  Tipo: System.Runtime.InteropServices.ComTypes.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
  Tipo: System.Runtime.InteropServices.ComTypes.ADVF
  Un valor de enumeración de ADVF que especifica un grupo de marcadores para controlar la conexión asesor.

• adviseSink
  Tipo: System.Runtime.InteropServices.ComTypes.IAdviseSink
  Un objeto de IAdviseSink que señala al receptor asesor que recibirá la notificación.

• connection
  Tipo: System.Int32%
  Parámetro de salida.Cuando este método vuelve, 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.Si este valor es cero, indicará que no se estableció la conexión.Este parámetro se pasa sin inicializar.

Valor devuelto

Tipo: System.Int32
Este método admite los valores devueltos estándar E_INVALIDARG, E_UNEXPECTED, y E_OUTOFMEMORY, así como el siguiente:

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; sólo -1 se admite actualmente.
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

IDataObject.DAdvise(FORMATETC%, ADVF, IAdviseSink, Int32%)

Comentarios

Este método delega la llamada al DAdvise correspondiente del espacio de nombres de System.Runtime.InteropServices.ComTypes , suponiendo que el objeto del portapapeles está ajustando IDataObjectexistente.

Seguridad de .NET Framework

• Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

ClipboardObject Clase

Microsoft.VisualStudio.Data.Framework (Espacio de nombres)