CreateMAPIInitializationMonitor
S’applique à : Outlook 2016 | Outlook 2019
Moniteur d’initialisation MAPI
Il arrive qu’une application qui consomme MAPI souhaite savoir quand l’initialisation est terminée. Par exemple, il a plusieurs threads qui peuvent initialiser MAPI ou, en réponse à l’initialisation de MAPI, l’application souhaite effectuer un certain travail, mais ne souhaite pas toujours faire tourner la pile MAPI. Le moniteur d’initialisation fournit cette fonctionnalité via une fonction (exportée à partir de OLMAPI32.DLL) et quelques interfaces simples décrites ci-dessous.
HRESULT CreateMAPIInitializationMonitor(IMAPIInitMonitor** ppInitMonitor);
HRESULT STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)
Ce point d’entrée exporté à partir de OLMAPI32.DLL permet à l’appelant de récupérer une interface pour interroger l’état d’initialisation actuel, de configurer un rappel pour la fin de l’initialisation ou de bloquer le thread actuel jusqu’à ce que soit terminé. L’objet retourné à partir de cette API est réutilisable et thread-safe et peut être appelé à partir de n’importe quel thread, pas seulement du thread qui l’a récupéré. En outre, contrairement aux autres objets exposés à partir de MAPI, cet objet est valide tant que la DLL est chargée, il peut être réutilisé entre les sessions d’initialisation et peut être consommé avant ou après l’appel de MAPIInitialize. Retourne la réussite ou l’échec par le biais d’un HRESULT standard COM, et affecte un paramètre out à un instance de IMAPIInitMonitor.
Paramètres
ppInitMonitor
[out] Pointeur pour recevoir les instance nouvellement créées du moniteur d’initialisation MAPI.
Valeurs de retour
S_OK
Une nouvelle instance du moniteur d’initialisation a été créée avec succès.
E_OUTOFMEMORY
Il n’y avait pas assez de mémoire pour crater un nouvel objet.