Compartilhar via


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

Definição

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

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.

Aplica-se a