ClipboardObject.IDataObject.DAdvise Método

Definição

Namespace:

Microsoft.VisualStudio.Data.Framework

Assembly:

Microsoft.VisualStudio.Data.Framework.dll

Cria uma conexão entre o objeto da área de transferência e um coletor de consultoria. Este método é chamado por um objeto compatível com um coletor de consultoria e o habilita para ser notificado sobre alterações nos dados do 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

Uma estrutura FORMATETC, passada por referência, que define o formato, dispositivo de destino, aspecto e meio que serão usados para notificações futuras.

advf

ADVF

Um valor da ADVF enumeração que especifica um grupo de sinalizadores para controlar a conexão de consultoria.

adviseSink

IAdviseSink

Um IAdviseSink objeto que aponta para o coletor de consultoria que receberá a notificação de alteração.

connection

Int32

Parâmetro de saída. Quando esse método retorna, esse parâmetro contém um token que identifica essa conexão. É possível usar esse token posteriormente para excluir a conexão de consultoria, passando-o para IDataObject.DUnadvise(Int32). Se esse valor for zero, a conexão não terá sido estabelecida. Este parâmetro é passado não inicializado.

Retornos

Int32

Esse método dá suporte aos valores retornados padrão E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, bem como o seguinte: ValueDescriptionS_OKThe conexão de consultoria foi criada. E_NOTIMPLThis método não é implementado nos dados object.DV_E_LINDEXThere é um valor inválido para lindex; atualmente, apenas -1 é supported.DV_E_FORMATETCThere é um valor inválido para o pFormatetc parâmetro . OLE_E_ADVISENOTSUPPORTEDThe objeto de dados não dá suporte à notificação de alteração.

Implementações

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)