IOleObject::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 do qual o objeto de chamada recebe notificação quando o objeto documento composto é renomeado, salvar, ou fechada.
Syntax
HRESULT Advise(
IAdviseSink* pAdvSink,
DWORD* pdwConnection
);
Parameters
- pAdvSink
[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, as well as S_OK, que indica que de consultoria conexões configurar 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 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
IOleObject
CreateOleAdviseHolder
IAdviseSink
IOleAdviseHolder
IOleAdviseHolder::Unadvise
IOleObject
IUnknown::AddRef
IUnknown::Release