Compartilhar via


DataObject.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.

 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

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

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.

Aplica-se a