DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Cria uma conexão entre um objeto de dados 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 ^ 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 -> int

Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, pAdvSink As IAdviseSink, ByRef pdwConnection 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 dos valores ADVF que especifica um grupo de sinalizadores para controlar a conexão de consultoria.

pAdvSink

IAdviseSink

Um ponteiro para a interface IAdviseSink no coletor de consultoria que receberá a notificação de alteração.

pdwConnection

Int32

Quando esse método retornar, conterá um ponteiro para um token DWORD que identifica esta conexão. É possível usar esse token posteriormente para excluir a conexão de consultoria, passando-o para DUnadvise(Int32). Se esse valor for zero, a conexão não terá sido estabelecida. Este parâmetro é passado não inicializado.

Retornos

Int32

Este método é compatível com os valores retornados padrão E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY e também com os seguintes:

Valor	Descrição
S_OK	A conexão de consultoria foi criada.
E_NOTIMPL	Este método não é implementado no objeto de dados.
DV_E_LINDEX	Há um valor inválido para lindex; no momento, apenas -1 é compatível.
DV_E_FORMATETC	Há um valor inválido para o parâmetro pFormatetc.
OLE_E_ADVISENOTSUPPORTED	O objeto de dados não é compatível com a notificação de alteração.

Implementações

DAdvise(FORMATETC, ADVF, IAdviseSink, Int32)

Comentários

Este membro é uma implementação do membro de interface explícita. Ele só pode ser usado quando o DataObject é convertido em uma IDataObject interface.