Método ClipboardObject.IDataObject.DAdvise

Artigo
10/26/2012

Cria uma conexão entre o objeto da área de transferência e o coletor consultivo.Este método é chamado por um objeto que suporta um coletor consultivo e permite que o coletor consultivo a ser notificado de alterações nos dados do objeto.

Namespace: Microsoft.VisualStudio.Data.Framework
Assembly: Microsoft.VisualStudio.Data.Framework (em Microsoft.VisualStudio.Data.Framework.dll)

Sintaxe

'Declaração
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 não oferece suporte a implementações explícitas da interface.

Parâmetros

pFormatetc
Tipo: System.Runtime.InteropServices.ComTypes.FORMATETC%
Uma estrutura de FORMATETC , passada por referência, que define o formato, o dispositivo de destino, a aparência, e o meio que será usado para notificações futuras.

advf
Tipo: System.Runtime.InteropServices.ComTypes.ADVF
Um valor de enumeração de ADVF que especifica um grupo de sinalizadores para controlar a conexão consultiva.

adviseSink
Tipo: System.Runtime.InteropServices.ComTypes.IAdviseSink
Um objeto de IAdviseSink que aponta para o coletor consultivo que receberá notificação de alteração.

connection
Tipo: System.Int32%
Para fora parâmetro.Quando esse método retornar, este parâmetro contém um símbolo que identifica a conexão.Você pode usar este token posteriormente para excluir a conexão consultiva passando à IDataObject.DUnadvise.Se esse valor é zero, a conexão não foi estabelecido.Esse parâmetro é passado não inicializado.

Valor de retorno

Tipo: System.Int32
Esse método oferece suporte aos valores de retorno padrão E_INVALIDARG, E_UNEXPECTED, e E_OUTOFMEMORY, bem como o seguinte:

Valor	Descrição
S_OK	a conexão consultiva foi criada.
E_NOTIMPL	Este método não é implementado no objeto de dados.
DV_E_LINDEX	Há um valor inválido para lindex; somente -1 são atualmente suportados.
DV_E_FORMATETC	Há um valor válido para o parâmetro de pFormatetc .
OLE_E_ADVISENOTSUPPORTED	O objeto de dados não oferece suporte a notificação de alteração.

Implementações

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

Comentários

Este método delega a chamada para DAdvise correspondente do namespace de System.Runtime.InteropServices.ComTypes , supondo que o objeto da área de transferência é envolvendo IDataObjectexistente.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

ClipboardObject Classe

Namespace Microsoft.VisualStudio.Data.Framework

Partilhar via