IMAPIProviderShutdown : IUnknown
S’applique à : Outlook 2013 | Outlook 2016
Permet au sous-système MAPI d’informer un fournisseur MAPI de l’arrêt rapide d’un client MAPI, afin que le fournisseur MAPI puisse répondre à l’arrêt.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapidefs.h |
| Exposé par : |
Objets fournisseur : IXPProvider, IABProvider ou IMSProvider |
| Implémenté par : |
Fournisseur MAPI |
| Appelé par : |
Sous-système MAPI |
| Identificateur d’interface : |
IID_IMAPIProviderShutdown |
| Type de pointeur : |
LPMAPIPROVIDERSHUTDOWN |
Ordre de la table de Vtable
| Propriété | Valeur |
|---|---|
| QueryFastShutdown |
Interroge le fournisseur MAPI pour obtenir la prise en charge de l’arrêt rapide. |
| NotifyProcessShutdown |
Indique au fournisseur MAPI qu’un client MAPI va effectuer un arrêt rapide, afin que le fournisseur puisse prendre des mesures pour empêcher la perte de données. |
| DoFastShutdown |
Indique au fournisseur MAPI que le client MAPI se ferme immédiatement, afin que le fournisseur MAPI conserve les modifications pour éviter toute perte de données. |
Remarques
L’arrêt rapide permet à un client MAPI de quitter son processus en peu de temps, une fois que le client et les fournisseurs MAPI chargés ont enregistré les paramètres et les données MAPI. Le client MAPI lance toujours un arrêt rapide et doit interroger le sous-système MAPI pour obtenir la prise en charge de l’arrêt rapide à partir des fournisseurs MAPI chargés. Un administrateur peut définir le Registre Windows au niveau de l’utilisateur pour spécifier le niveau de prise en charge du fournisseur nécessaire pour permettre l’arrêt rapide de tous les clients MAPI. Pour plus d’informations sur les paramètres du Registre, consultez Options utilisateur d’arrêt rapide. Toutefois, pour que l’arrêt rapide se produise correctement sans perte de données, les fournisseurs MAPI doivent implémenter l’interface IMAPIProviderShutdown .
Un fournisseur MAPI qui doit prendre en charge l’arrêt rapide du client doit retourner S_OK au sous-système MAPI dans la méthode IMAPIProviderShutdown ::QueryFastShutdown . Lorsque le sous-système MAPI appelle par la suite les méthodes IMAPIProviderShutdown ::NotifyProcessShutdown et IMAPIProviderShutdown ::D oFastShutdown , le fournisseur MAPI doit prendre les mesures nécessaires pour enregistrer les paramètres et les données MAPI et préparer la sortie du client.
Les fournisseurs MAPI qui n’ont pas besoin de prendre en charge l’arrêt rapide du client doivent quand même implémenter l’interface IMAPIProviderShutdown et que la méthode IMAPIProviderShutdown ::QueryFastShutdown retourne MAPI_E_NO_SUPPORT. Pour Outlook en tant que client MAPI, outlook attend que toutes les références externes soient publiées avant de se fermer.
Selon le paramètre de Registre Windows de l’utilisateur pour l’arrêt rapide, le fait de ne pas implémenter l’interface IMAPIProviderShutdown n’empêche pas nécessairement l’arrêt rapide d’un client.
Pour plus d’informations sur le processus d’arrêt rapide, consultez Vue d’ensemble de l’arrêt rapide. Pour plus d’informations sur la façon d’effectuer un arrêt rapide avec succès, consultez Meilleures pratiques pour l’arrêt rapide.