Registrando-se para uma notificação

Aplica-se a: Outlook 2013 | Outlook 2016

Um cliente pode se registrar para receber notificações do catálogo de endereços ou do repositório de mensagens como parte do processo de inicialização.

O MAPI dá suporte à notificação no catálogo de endereços, independentemente de qualquer um dos provedores de catálogo de endereços dar suporte a ele. O suporte para notificação em armazenamentos de mensagens depende do provedor específico do repositório de mensagens. Para determinar se um determinado provedor de repositório de mensagens dá suporte a notificações, marcar sua propriedade PR_STORE_SUPPORT_MASK (PidTagStoreSupportMask). Se o repositório de mensagens der suporte a notificações, o bit de STORE_NOTIFY_OK será definido.

Registre-se para receber notificações chamando o método Advise do objeto de origem do aviso. Muitos objetos implementam o Advise e os clientes podem se registrar com esses objetos de várias maneiras.

Para se registrar para receber uma notificação

1. Crie um objeto coletor de aviso MAPI e aumente sua contagem de referência.

2. Se apropriado, chame HrThisThreadAdviseSink para criar um objeto de coletor de aconselhamento que envolva o coletor de aconselhamento original e, em seguida, libere o coletor de aconselhamento original.

3. Chame um dos seguintes métodos de aconselhamento para concluir o registro:

• Chame IMAPISession::Advise para se registrar para notificações de sessão ou para notificações em um catálogo de endereços ou objeto de repositório de mensagens.

• Chame IAddrBook::Advise para se registrar para notificações do catálogo de endereços ou para notificações sobre um usuário de mensagens, contêiner ou lista de distribuição.

• Chame IABLogon::Advise para se registrar diretamente com um provedor de catálogo de endereços para notificações sobre um usuário de mensagens, contêiner ou lista de distribuição.

• Chame IMsgStore::Advise para se registrar para notificações do repositório de mensagens ou para notificações em uma pasta ou mensagem.

• Chame IMSLogon::Advise para se registrar diretamente com um provedor de repositório de mensagens para notificações em uma pasta ou mensagem.

• Chame IMAPITable::Advise para se registrar para notificações de tabela.

4. Armazene em cache o número de conexão retornado do Aconselhar.

5. Se estiver usando um coletor de aviso encapsulado, solte-o. Depois que o coletor de aviso encapsulado for registrado, você não precisará mais dele.

Chamar IMAPISession::Advise permite que você se registre para notificações de erro crítico na sessão geral ou para várias notificações em objetos individuais. As sessões enviam notificações de erro crítico para clientes conectados a sessões compartilhadas quando outro cliente usando a sessão compartilhada chama o método IMAPISession::Logoff . Para se registrar para notificações de sessão, passe NULL para o parâmetro do identificador de entrada. Para se registrar para receber notificações sobre um objeto individual, passe o identificador de entrada do objeto. O método IMAPISession encaminha a chamada para o provedor de serviços apropriado, conforme determinado pela parte MAPIUID do identificador de entrada. Chamar IMAPISession::Advise para se registrar para notificações de objeto é mais simples do que chamar o método Advise de um provedor de serviços.

O registro no catálogo de endereços é semelhante ao registro na sessão. Para se registrar para notificação de erro crítico do catálogo de endereços, passe NULL para o identificador de entrada. Para se registrar para receber notificações sobre um objeto de catálogo de endereços específico, especifique o identificador de entrada apropriado e o evento ou eventos de interesse. Lembre-se de que muitos provedores de catálogo de endereços não dão suporte a notificações em objetos individuais. Em vez disso, eles dão suporte a notificações de tabela em seu conteúdo e tabelas hierárquicas.

É uma boa prática liberar o coletor de aviso que você implementa ou cria com HrAllocAdviseSink imediatamente após um retorno bem-sucedido de uma chamada de aconselhamento . Isso ocorre porque é possível que os provedores de serviços liberem seu coletor de aviso após a chamada de aconselhamento , mas antes que uma chamada de aviso seja feita. Depois de dar à fonte de aconselhamento um ponteiro para o coletor de aconselhamento e a contagem de referência tiver sido incrementada neste coletor de aconselhamento, é aconselhável liberá-lo, a menos que você tenha um uso de longo prazo para ele.