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

Definição

Espaço de Nomes:
System.Runtime.InteropServices.ComTypes
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

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.

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

adviseSink
IAdviseSink

Um apontador para a IAdviseSink interface no suporte de aviso que receberá a notificação de alteração.

connection
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

Int32

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.

Observações

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

Aplica-se a