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