Manipular notificações

Aplica-se a: Outlook 2013 | Outlook 2016

As notificações permitem que um objeto informe a outro objeto que ele foi submetido a uma alteração. O tipo de alteração é conhecido como um 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. Os objetos que podem atuar como fontes de aviso 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 : IUnknown e está dentro de um aplicativo cliente.

Os objetos de origem do Advise implementam um método Dissel, que é chamado pelos clientes para se registrarem para notificações, e um método Unadvise Um dos parâmetros a serem aconselhados é um ponteiro para uma implementação de IMAPIAdviseSink ou IMAPIViewAdviseSink**. A origem do aviso armazena em cache esse ponteiro para que possa chamar IMAPIAdviseSink::OnNotify ou um dos métodos emIMAPIViewAdviseSink 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, é opcional.

Nesta seção

• Registrando-se 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 de 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 lidar com notificações do catálogo de endereços.

• Notificação de tabela de manipulação: descreve como se registrar para notificações da tabela de hierarquia.

• Implementando um objeto de coletor de aconselhamento: descreve como implementar um objeto de coletor de aconselhamento.

• Cronometrando uma notificação: Descreve o tempo de notificação do cliente por provedores de serviços.

• Garantindo uma notificação Thread-Safe: descreve como garantir uma notificação thread-safe com MAPI.

• Forçando uma notificação: Descreve como forçar uma notificação em MAPI.