IOleAdviseHolder

9/8/2008

Essa interface gerencia de consultoria conexões e notificações documento composto em um servidor objeto.

O IOleAdviseHolder interface contém métodos que de consultoria gerenciar conexões e notificações documento composto em um servidor objeto. Seus métodos servem para ser usado para implementar a de consultoria métodos IOleObject.

IOleAdviseHolder é implementada em um objeto reservado Advise. Seus métodos estabelecer e exclua de consultoria conexões a partir de objeto gerenciado, o servidor para contêiner do objeto, que deve conter um coletor de avisos (suporte a IAdviseSink interface).

O objeto reservado Advise também deve manter controlar de qual Advise coletores estão interessados no qual as notificações e transmitir junto as notificações como apropriado.

Quando a implementar

É improvável que você faria implementar essa interface. OLE fornece uma implementação de reservado informar o OLE como uma conveniência para os programadores. Alguns aplicativos requerem notificação recursos além daqueles que fornece o reservado informar usar como padrão.

Em geral, um aplicativo servidor único que requer recursos diferentes notificação seria implementar a de consultoria a funcionalidade no seu IOleObject de consultoria métodos.

É necessário para implementar IOleAdviseHolder Somente na maiúsculas e minúsculas onde poderá haver a necessidade de um personalizado objeto reservado informar, cujos métodos devem ser usados para implementar o IOleObject Métodos em um conjunto de servidores.

Quando usar

Chamar os métodos de IOleAdviseHolder Para implementar a de consultoria métodos IOleObject. Aplicativos criar instância um reservado informar OLE por chamado a função OLE CreateOleAdviseHolder.

Recipientes e outros objetos que precisam receber notificações documento composto devem implementar o IAdviseSink interface para receber as notificações e chamar o IOleAdviseHolder Métodos interface para estabelecer uma de consultoria conexão e informar o objeto do que notificações específicas ele quer receber.

Métodos

A seguinte tabela mostra os métodos para esta interface no ordem alfabética. Como todas as interfaces COM, essa interface herda os métodos para a IUnknown interface.

Método	Descrição
IOleAdviseHolder::Advise	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.
IOleAdviseHolder::EnumAdvise	Esse método cria um enumerador que pode ser usado para enumerar a de consultoria conexões estabelecidas para um objeto e fornece um ponteiro para sua IEnumSTATDATA interface.
IOleAdviseHolder::SendOnClose	Este método envia IAdviseSink::OnRename As notificações para todos os de consultoria coletores registrados com o reservado Advise.
IOleAdviseHolder::SendOnRename	Este método envia IAdviseSink::OnSave As notificações para todos os de consultoria coletores registrados com o reservado Advise.
IOleAdviseHolder::SendOnSave	Este método envia notificações para todos os de consultoria coletores registrados com o reservado Advise.
IOleAdviseHolder::Unadvise	Esse método exclui uma de consultoria anteriormente estabelecida conexão.

Remarks

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Requisitos

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

OLE Interfaces
CreateOleAdviseHolder
IAdviseSink
IOleObject
IUnknown

Concepts

Determining Supported COM APIs