Partager via


À propos de l’API d’état hors connexion

S’applique à : Outlook 2013 | Outlook 2016

L’API État hors connexion prend en charge les rappels indiquant les modifications apportées à l’état de connexion d’un utilisateur dans Microsoft Outlook 2013 et Microsoft Outlook 2010, par exemple, d’être en ligne dans Outlook 2013 ou Outlook 2010 à être hors connexion. L’API utilise un objet hors connexion global dans Outlook 2013 ou Outlook 2010 pour suivre ces modifications pour un profil de compte d’utilisateur donné. La notification est la seule forme de rappel prise en charge. En tant que clients de cette API, les fournisseurs de messagerie qui souhaitent être avertis de ces changements d’état de connexion effectuent les opérations suivantes :

  1. Implémentez IMAPIOfflineNotify.

  2. Ouvrez un objet hors connexion existant pour un profil spécifique à l’aide de HrOpenOfflineObj.

  3. Déterminez si l’objet peut fournir des notifications en ligne ou hors connexion à l’aide de IMAPIOffline ::GetCapabilities.

  4. Inscrivez l’objet pour les notifications en ligne ou hors connexion à l’aide de IMAPIOfflineMgr ::Advise. Les fournisseurs de messagerie peuvent désormais recevoir des notifications qu’Outlook 2013 ou Outlook 2010 envoient à l’aide de IMAPIOfflineNotify.

  5. Lors de l’arrêt, supprimez l’inscription pour les notifications en ligne et hors connexion à l’aide de IMAPIOfflineMgr ::Unadvise.

Remarque

En général, Outlook 2013 et Outlook 2010 peuvent informer un client des modifications en ligne/hors connexion, ainsi que d’autres modifications, mais l’API État hors connexion prend uniquement en charge les notifications pour les modifications en ligne/hors connexion. Le client doit ignorer toutes les autres notifications. Pour plus d’informations, consultez IMAPIOfflineNotify ::Notify et MAPIOFFLINE_NOTIFY.

Pour obtenir un exemple de client qui utilise l’API d’état hors connexion, consultez À propos de l’exemple de complément d’état hors connexion. L’exemple de complément d’état hors connexion est un complément COM qui utilise l’API d’état hors connexion pour surveiller et modifier l’état de la connexion.

Cette API fournit les éléments suivants :

Définitions :

Types de données :

Fonctions :

Interfaces :