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

Definição

Namespace:
System.Runtime.InteropServices.ComTypes
Assembly:
System.dll
Assembly:
netstandard.dll

Cria uma conexão entre um objeto de dados e um coletor de consultoria. Esse método é chamado por um objeto que dá suporte a um coletor de consultoria e permite que o coletor de consultoria seja 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 FORMATETC estrutura, passada por referência, que define o formato, o dispositivo de destino, o aspecto e o meio que serão usados para notificações futuras.

advf
ADVF

Um dos ADVF valores que especifica um grupo de sinalizadores para controlar a conexão de consultoria.

adviseSink
IAdviseSink

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

connection
Int32

Quando esse método é retornado, contém um ponteiro para um token DWORD que identifica essa conexão. Você pode usar esse token mais tarde para excluir a conexão de consultoria passando-a para DUnadvise(Int32). Se esse valor for zero, a conexão não foi estabelecida. Esse parâmetro é passado sem inicialização.

Retornos

Int32

Esse método dá suporte aos valores retornados padrão E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, bem como o seguinte:

Valor Descrição
S_OK A conexão de consultoria foi criada.
E_NOTIMPL Esse método não é implementado no objeto de dados.
DV_E_LINDEX Há um valor inválido para lindex; atualmente, há suporte apenas -1.
DV_E_FORMATETC Há um valor inválido para o pFormatetc parâmetro.
OLE_E_ADVISENOTSUPPORTED O objeto de dados não dá suporte à notificação de alteração.

Comentários

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

Aplica-se a