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

Definição

Namespace:

System.Runtime.InteropServices.ComTypes

Assembly:

System.Runtime.InteropServices.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.

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 -> int

Public Function DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, adviseSink As IAdviseSink, ByRef connection As Integer) As Integer

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.

adviseSink

IAdviseSink

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

connection

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.

Comentários

Para obter mais informações, consulte Método IDataObject::D Advise.