IOleAdviseHolder::Advise
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Este método estabelece uma de consultoria conexão entre um objeto OLE e coletor de avisos do o objeto de chamada. Através desse coletor, o objeto de chamada pode receber notificação quando o objeto OLE é renomeado, salvo ou fechado.
Syntax
HRESULT Advise(
IAdviseSink* pAdvise,
DWORD* pdwConnection
);
Parameters
- pAdvise
[no] Ponteiro para o IAdviseSink interface de coletor de avisos que devem ser informados das alterações.
pdwConnection
[out] Ponteiro para um token que pode ser passado para o IOleAdviseHolder::Unadvise método para excluir a de consultoria conexão.O objeto de chamada é responsável por chamado dois IUnknown::AddRef e IUnknown::Release Sobre este ponteiro.
Return Value
Este método oferece suporte a padrão valor de retorno E_INVALIDARG, como bem como S_OK, que indica que o de consultoria conexões foram configuradas com êxito.
Remarks
Criam recipientes, manipuladores objeto e objetos link coletores informar para receber notificação de alterações em compostos-documento objetos de interesse, such as incorporado ou vinculado objetos.
Objetos OLE de interesse para esses objetos devem implementar a IOleObject interface, que inclui vários de consultoria métodos, incluindo IOleObject::Advise.
Um chamar para esse método deve configurar uma de consultoria conexão com qualquer coletor de avisos que chama-lo e manter cada conexão até que ele é fechado. Ele deve ser capaz identificador mais de de consultoria uma conexão em um tempo.
IOleAdviseHolder::Advise Destina-se a ser usado para simplificar a implementação de IOleObject::Advise.
Você pode get um ponteiro para a implementação do OLE IOleAdviseHolder Por chamado CreateOleAdviseHoldere em seguida, para implementar IOleObject::Advise, delegado apenas a chamar para IOleAdviseHolder::Advise.
Outros IOleAdviseHolder Métodos servem para implementar outro IOleObject de consultoria métodos.
Se a tentativa de estabelecer uma de consultoria conexão é bem-sucedido, o objeto recebendo o chamar retorna um diferente de zero valor através de pdwConnection. Se a tentativa falhar, o objeto retorna um zero.
Para excluir uma de consultoria conexão, o objeto com o coletor de avisos passa este diferente de zero token voltar para o objeto por chamado IOleAdviseHolder::Unadvise.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Requirements
| Header | Oleidl.h, oleidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IOleAdviseHolder
CreateOleAdviseHolder
IOleAdviseHolder::Unadvise
IOleObject
IOleObject::Advise
IUnknown::AddRef
IUnknown::Release