Compartilhar via

MAPIOFFLINE_NOTIFY

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Essa é a notificação para uma alteração no estado de conexão. Ele indica a parte do estado de conexão que foi alterada, o estado de conexão antigo e o novo estado de conexão.

Informações rápidas

Consulte IMAPIOfflineNotify.

typedef struct  
{ 
      ULONG ulSize; 
      MAPIOFFLINE_NOTIFY_TYPE NotifyType; 
      ULONG ulClientToken; 
      union { 
         struct 
           { 
           ULONG ulMask; 
           ULONG ulStateOld; 
           ULONG ulStateNew; 
           } StateChange; 
             } Info; 
} MAPIOFFLINE_NOTIFY;

Members

ulSize

Tamanho da estrutura MAPIOFFLINE_NOTIFY .

NotifyType

Tipo de notificação. Observe que há suporte apenas para notificação sobre a alteração do estado de conexão; os únicos valores com suporte são:

  • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START
    • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE
    • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE

ulClientToken

Um token definido pelo cliente na estrutura MAPIOFFLINE_ADVISEINFO no IMAPIOfflineMgr::Advise.

Ulmask

A parte do estado de conexão que foi alterada. O único valor com suporte é MAPIOFFLINE_STATE_OFFLINE_MASK.

ulStateOld

O antigo estado de conexão. Os únicos valores com suporte são:

  • MAPIOFFLINE_STATE_OFFLINE
  • MAPIOFFLINE_STATE_ONLINE

ulStateNew

O novo estado de conexão. Os únicos valores com suporte são:

  • MAPIOFFLINE_STATE_OFFLINE
  • MAPIOFFLINE_STATE_ONLINE

Comentários

A API de Estado Offline dá suporte apenas a notificações para alterações online/offline. Um cliente deve marcar que o Outlook retorne os seguintes valores antes de examinar a alteração real:

  1. NotifyType tem o valor MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START, MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE ou MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE. Nesse caso, o cliente pode assumir que a alteração é uma alteração de estado de conexão e As informações são da estrutura StateChange.

  2. ulMask tem o valor MAPIOFFLINE_STATE_OFFLINE_MASK. Nesse caso, o cliente pode assumir que a alteração é uma alteração de estado de conexão online/offline e pode continuar examinando ulStateOld e ulStateNew.

É possível que o Outlook notifique um cliente de outras alterações que não têm suporte. Nesses casos, NotifyType não seria um dos três valores declarados anteriormente ou ulMask não seria MAPIOFFLINE_STATE_OFFLINE_MASK e o cliente deve ignorar o restante dos dados em Informações.

Confira também