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 no Microsoft Outlook 2013 e no Microsoft Outlook 2010—por exemplo, de estar online no Outlook 2013 ou Outlook 2010 para estar offline. A API usa um objeto offline global no Outlook 2013 ou Outlook 2010 para rastrear essas alterações para um determinado perfil de conta de usuário. A notificação é a única forma com suporte de retorno de chamada. 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 para notificações online e offline usando IMAPIOfflineMgr::Unadvise.

Observação

Em geral, o Outlook 2013 e o Outlook 2010 podem notificar um cliente sobre alterações online/offline, bem como outras alterações, mas a API de Estado Offline dá suporte apenas a notificações de 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 da conexão.

Essa API fornece o seguinte:

Definições:

Tipos de dados:

Funções:

Interfaces:

  • Last updated on