Compartir a través de

MAPIOFFLINE_NOTIFY

  • Artículo

Hace referencia a: Outlook 2013 | Outlook 2016

Esta es la notificación de un cambio en el estado de conexión. Indica la parte del estado de conexión que ha cambiado, el estado de conexión anterior y el nuevo estado de conexión.

Información rápida

Vea 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

Tamaño de la estructura MAPIOFFLINE_NOTIFY .

NotifyType

Tipo de notificación. Tenga en cuenta que solo se admite la notificación al cambiar el estado de conexión; los únicos valores admitidos son:

  • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START
    • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE
    • MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE

ulClientToken

Token definido por el cliente en la estructura MAPIOFFLINE_ADVISEINFO de IMAPIOfflineMgr::Advise.

ulMask

Parte del estado de conexión que ha cambiado. El único valor admitido es MAPIOFFLINE_STATE_OFFLINE_MASK.

ulStateOld

Estado de conexión anterior. Los únicos valores admitidos son:

  • MAPIOFFLINE_STATE_OFFLINE
  • MAPIOFFLINE_STATE_ONLINE

ulStateNew

Nuevo estado de conexión. Los únicos valores admitidos son:

  • MAPIOFFLINE_STATE_OFFLINE
  • MAPIOFFLINE_STATE_ONLINE

Comentarios

La API de estado sin conexión solo admite notificaciones para cambios en línea o sin conexión. Un cliente debe comprobar que Outlook devuelve los siguientes valores antes de examinar el cambio real:

  1. NotifyType tiene el valor MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_START, MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE o MAPIOFFLINE_NOTIFY_TYPE_STATECHANGE_DONE. En este caso, el cliente puede suponer que el cambio es un cambio de estado de conexión y que la información es de la estructura StateChange.

  2. ulMask tiene el valor MAPIOFFLINE_STATE_OFFLINE_MASK. En este caso, el cliente puede suponer que el cambio es un cambio de estado de conexión en línea o sin conexión y puede continuar con el examen de ulStateOld y ulStateNew.

Es posible que Outlook notifique a un cliente otros cambios que no se admiten. En tales casos, NotifyType no sería ninguno de los tres valores indicados anteriormente, o ulMask no sería MAPIOFFLINE_STATE_OFFLINE_MASK y el cliente debe omitir el resto de los datos de Info.

Vea también