Compartilhar via


Sobre a API de estado offline

Aplica-se a: Outlook 2013 | Outlook 2016

A API de Estado Offline dá suporte a retornos de chamada que indicam alterações no estado de conexão de um usuário em Microsoft Outlook 2013 e Microsoft Outlook 2010, por exemplo, desde estar online no Outlook 2013 ou Outlook 2010 até estar offline. A API usa um objeto offline global no Outlook 2013 ou outlook 2010 para acompanhar essas alterações para um determinado perfil de conta de usuário. A notificação é a única forma de retorno de chamada com suporte. Como clientes dessa API, os provedores de email que desejam ser notificados sobre essas alterações de estado de conexão fazem o seguinte:

  1. Implemente IMAPIOfflineNotify.

  2. Abra um objeto offline existente para um perfil específico usando HrOpenOfflineObj.

  3. Determine se o objeto tem a capacidade de fornecer notificações online ou offline usando IMAPIOffline::GetCapabilities.

  4. Registre o objeto para notificações online ou offline usando IMAPIOfflineMgr::Advise. Os provedores de email agora podem receber notificações que o Outlook 2013 ou o Outlook 2010 enviam usando IMAPIOfflineNotify.

  5. No desligamento, remova o registro de notificações online e offline usando IMAPIOfflineMgr::Unadvise.

Observação

Em geral, o Outlook 2013 e o Outlook 2010 podem notificar um cliente de alterações online/offline, bem como outras alterações, mas a API de Estado Offline dá suporte apenas a notificações para alterações online/offline. O cliente deve ignorar todas as outras notificações. Para obter mais informações, consulte IMAPIOfflineNotify::Notify e MAPIOFFLINE_NOTIFY.

Para obter um exemplo de um cliente que usa a API de Estado Offline, consulte Sobre o suplemento de estado offline de exemplo. O Suplemento de Estado Offline de Exemplo é um suplemento COM que usa a API de Estado Offline para monitorar e alterar o estado de conexão.

Esta API fornece o seguinte:

Definições:

Tipos de dados:

Funções:

Interfaces: