DataObject.IDataObject.DAdvise(FORMATETC, ADVF, IAdviseSink, Int32) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Cria uma ligação entre um objeto de dados e um sumidouro de aviso. Este método é chamado por um objeto que suporta um sumidouro de aviso e permite que o sumidouro de aviso seja notificado de 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, dispositivo alvo, aspeto e meio que serão usados para futuras notificações.
- advf
- ADVF
Um dos ADVF valores que especifica um grupo de bandeiras para controlar a ligação consultiva.
- pAdvSink
- IAdviseSink
Um apontador para a IAdviseSink interface no suporte de aviso que receberá a notificação de alteração.
- pdwConnection
- Int32
Quando este método retorna, contém um ponteiro para um token DWORD que identifica esta ligação. Pode usar este token mais tarde para eliminar a ligação de aviso, passando-a para DUnadvise(Int32). Se este valor for zero, a ligação não foi estabelecida. Este parâmetro é passado sem inicializar.
Devoluções
Este método suporta os valores padrão de retorno E_INVALIDARG, E_UNEXPECTED e E_OUTOFMEMORY, bem como os seguintes:
| Valor | Descrição |
|---|---|
| S_OK | Foi criada a ligação consultiva. |
| E_NOTIMPL | Este método não é implementado no objeto de dados. |
| DV_E_LINDEX | Existe um valor inválido para lindex; atualmente, apenas -1 é suportado. |
| DV_E_FORMATETC | Existe um valor inválido para o pFormatetc parâmetro.
|
| OLE_E_ADVISENOTSUPPORTED | O objeto de dados não suporta notificação de alteração. |
Implementações
Observações
Este membro é uma implementação explícita de membro de interface. Só pode ser usado quando é DataObject transmitido para uma IDataObject interface.