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

Referência

Definição

Namespace:: System.Runtime.InteropServices.ComTypes

Assembly:: System.Runtime.InteropServices.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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.

Aplica-se a

Compartilhar via