Meilleures pratiques en cas d’arrêt rapide
S’applique à : Outlook 2013 | Outlook 2016
Cette rubrique recommande les meilleures pratiques pour les administrateurs, les clients MAPI et les fournisseurs MAPI pour utiliser les paramètres du Registre Windows et les interfaces d’arrêt rapide pour réduire la perte de données pendant l’arrêt du client.
Pour qu’un client MAPI effectue correctement un arrêt rapide afin que les processus du fournisseur n’entraînent pas de perte de données, le client MAPI doit d’abord appeler la méthode IMAPIClientShutdown ::QueryFastShutdown . Le client doit ensuite poursuivre avec les méthodes IMAPIClientShutdown ::NotifyProcessShutdown et IMAPIClientShutdown ::D oFastShutdown en fonction de la prise en charge par le sous-système MAPI pour l’arrêt rapide, comme indiqué par la valeur de retour de IMAPIClientShutdown ::QueryFastShutdown. En tant que client MAPI, Microsoft Outlook n’appelle pas IMAPIClientShutdown ::NotifyProcessShutdown ou IMAPIClientShutdown ::D oFastShutdown si IMAPIClientShutdown ::QueryFastShutdown retourne une erreur. Si l’administrateur a désactivé l’arrêt rapide dans le Registre Windows, le sous-système MAPI retourne MAPI_E_NO_SUPPORT à IMAPIClientShutdown ::QueryFastShutdown. Dans ce cas, le sous-système MAPI n’informe pas les fournisseurs MAPI d’une sortie immédiate du processus client. Par conséquent, si un client MAPI ignore ce code de retour d’erreur, procède à un arrêt rapide et déconnecte toutes les références externes, tous les fournisseurs MAPI chargés ont une perte de données.
Les fournisseurs MAPI doivent implémenter l’interface IMAPIProviderShutdown : IUnknown pour effectuer en temps voulu les étapes nécessaires pour éviter la perte de données due à la déconnexion des références externes par le client avant la sortie du client. Un fournisseur doit reporter tout ce qui n’est pas essentiel à l’enregistrement des données dans son magasin de données principal. Par exemple, un fournisseur de transport doit reporter les opérations en arrière-plan inutiles qui case activée pour les nouveaux messages, un fournisseur de carnets d’adresses doit reporter le téléchargement des modifications récentes à partir de son serveur, et un fournisseur de magasin doit reporter les tâches de maintenance telles que le compactage ou l’indexation.
Les utilisateurs qui souhaitent que les clients MAPI se terminent dès qu’ils les ferment doivent utiliser le paramètre de Registre par défaut qui permet l’arrêt rapide, sauf si un fournisseur s’en désactive.
Une fois qu’un client MAPI appelle IMAPIClientShutdown ::D oFastShutdown, il ne doit pas effectuer d’appels supplémentaires à MAPI, y compris la fonction MAPIUninitialize . Le client ne doit pas utiliser MAPI pendant le reste de la durée de vie du processus client.
Un client MAPI ne doit jamais appeler directement l’interface IMAPIProviderShutdown d’un fournisseur. Les clients MAPI doivent toujours utiliser l’interface IMAPIClientShutdown : IUnknown .
Si un fournisseur MAPI doit s’assurer que l’arrêt rapide n’est pas utilisé pendant son chargement, il doit implémenter l’interface IMAPIProviderShutdown et retourner MAPI_E_NO_SUPPORT pour la méthode IMAPIProviderShutdown ::QueryFastShutdown . Toutefois, pour les clients MAPI tels qu’Outlook, cela entraîne l’abandon de l’arrêt rapide et l’arrêt prend plus de temps.