Manipular notificações
Aplica-se a: Outlook 2013 | Outlook 2016
As notificações permitem que um objeto informe outro objeto de que ele passou por uma alteração. O tipo de alteração é chamado de evento. O MAPI define vários eventos para os quais as notificações são geradas.
Os clientes normalmente se registram para um ou mais eventos com um ou mais objetos. Esses objetos são chamados de fontes de aconselhamento. Objetos que podem atuar como fontes de aconselhamento incluem o objeto de sessão, sob o controle do MAPI ou um objeto criado por um provedor de serviços, como uma mensagem. O objeto informado, conhecido como coletor de aconselhamento, contém uma implementação da interface IMAPIAdviseSink : IUnknown ou IMAPIViewAdviseSink : interface IUnknown e está dentro de um aplicativo cliente.
Aconselhar objetos de origem a implementar um método Advise , que é chamado pelos clientes para registrar para notificações, e um método Unadvise , que é chamado para cancelar um registro. Um dos parâmetros para Aconselhar é um ponteiro para uma implementação de IMAPIAdviseSink orIMAPIViewAdviseSink**. O assessora origem armazena esse ponteiro em cache para que ele possa chamar IMAPIAdviseSink::OnNotify ou um dos métodos noIMAPIViewAdviseSink quando ocorre uma alteração.
Como o recebimento de notificações permite que os usuários exibam as informações mais atualizadas, é recomendável que todos os clientes se registrem e manipulem as notificações. No entanto, ele é opcional.
Nesta seção
Registro para uma notificação: descreve como registrar um cliente para notificações como parte de seu processo de inicialização.
Cancelando uma notificação: descreve como cancelar uma assinatura para uma notificação.
Manipulando a notificação do Repositório de Mensagens: descreve como se registrar para notificações do repositório de mensagens.
Notificação do Catálogo de Endereços: descreve como se registrar e manipular notificações do catálogo de endereços.
Manipulação da Notificação de Tabela: descreve como se registrar para notificações da tabela de hierarquia.
Implementando um objeto Coletor de Aconselhamento: descreve como implementar um objeto de coletor de aconselhamento.
Cronometrar uma notificação: descreve o tempo de notificação do cliente pelos provedores de serviços.
Garantindo uma notificação Thread-Safe: descreve como garantir uma notificação segura por thread com MAPI.
Forçando uma notificação: descreve como forçar uma notificação no MAPI.