DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Método
Definição
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. 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.
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 -> intFunction DAdvise (ByRef pFormatetc As FORMATETC, advf As ADVF, pAdvSink As IAdviseSink, ByRef pdwConnection As Integer) As Integer Implements IDataObject.DAdviseParâ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.
- pAdvSink
- IAdviseSink
Um ponteiro para a IAdviseSink interface no coletor de consultoria que receberá a notificação de alteração.
- pdwConnection
- 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
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. |
Implementações
Comentários
Esse membro é uma implementação de membro de interface explícita. Ele só pode ser usado quando ele DataObject é convertido em uma IDataObject interface.