Nouveautés de cette édition
S’applique à : Outlook 2013 | Outlook 2016
La référence MAPI Microsoft Outlook a été mise à jour pour inclure la documentation relative aux différentes nouvelles fonctionnalités.
Nouveau contenu
Le contenu a été ajouté pour les fonctionnalités suivantes :
La rubrique Prise en main avec la référence MAPI Outlook 2013 a été mise à jour pour référencer des informations complètes sur les modèles de programmation pour vos fonctionnalités Outlook et MAPI afin de vous aider à identifier les API et les technologies les plus adaptées à vos besoins. Les liens vers l’article technique référencé ont également été révisés dans les rubriques suivantes :
Exemple de fournisseur de magasin de messages : l’exemple de code fournisseur de magasin PST encapsulé a été modifié pour reconnaître et prendre en charge Outlook 2013. Pour plus d’informations, consultez Contenu précédemment révisé dans cette rubrique.
Autocomplétion Stream : la rubrique cache des surnoms, anciennement format de fichier Nk2, a été mise à jour pour refléter les modifications apportées à Outlook 2013 et Outlook 2010. Les rubriques suivantes ont maintenant été révisées pour fournir des informations sur les instructions pour les développeurs de format de fichier .nk2 pour Microsoft Outlook 2003/Microsoft Office Outlook 2007 et l’analyse des fichiers binaires. Pour plus d’informations, consultez Contenu précédemment révisé dans cette rubrique.
Interfaces : la rubrique IAddrBook ::OpenEntry documente une méthode permettant d’ouvrir une entrée de carnet d’adresses et de retourner un pointeur vers l’interface utilisée pour y accéder. Il contenait précédemment un indicateur dans le paramètre ulFlags , MAPI_GAL_ONLY, qui pouvait être utilisé uniquement pour ouvrir la liste d’adresses globale (GAL), et a été modifié pour inclure sa définition.
Propriétés : la rubrique PR_CONVERSATION_KEY propriété nommée (Propriété canonique PidTagConversationKey) a été ajoutée et concerne IPM. Messages MessageManager dans Outlook MAPI uniquement. Les rubriques suivantes y relatives et la documentation du flux TNEF (Transport-Neutral Encapsulation Format) ont été révisées :
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 STDAPICALLTYPE CreateMapiInitializationMonitor(IMAPIInitMonitor ppInitMonitor)
- Il s’agit d’un point d’entrée exporté à partir de OLMAPI32.DLL cela 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 la fin soit terminée. 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.
Interface : IMAPIInitMonitor
IFACEMETHODIMP_(BOOL) IsInitialized()
- Retourne l’état actuel de l’initialisation MAPI
IFACEMETHODIMP Wait(DWORD timeout)
- Lance un appel BLOCKING sur ce thread, qui retourne soit lorsque le nombre de millisecondes spécifié s’est écoulé ou que MAPI a été initialisé. INFINITE peut être utilisé pour une attente infinie.
IFACEMETHODIMP BeginWait(DWORD timeout, IMAPIWaitResult ppResult)
- Démarrez une attente avant l’initialisation de MAPI ou le nombre spécifié de millisecondes à s’écouler. Cela retourne une interface IMAPIWaitResult qui doit avoir « End » appelé pour commencer l’attente. Cela permet à l’appelant de contrôler quel thread est bloqué pendant que nous attendons.
Interface IMAPIWaitResult
IFACEMETHODIMP End() override
- Appelé pour lancer l’attente de blocage sur le thread où il est appelé, n’a pas besoin d’être le même thread que celui appelé « BeginWait ».
Contenu précédemment révisé
Le contenu a été ajouté dans les versions précédentes de la référence MAPI Outlook pour les fonctionnalités suivantes :
Microsoft Outlook 2013 permet des scénarios de déploiement non traditionnels tels que côte à côte et Démarrer en un clic. Ces scénarios peuvent compliquer la logique utilisée pour charger la bibliothèque MAPI appropriée. Les développeurs MAPI ont désormais la possibilité de lier explicitement aux fonctions MAPI et peuvent choisir de lier explicitement au stub MAPI du client MAPI par défaut (par exemple, Msmapi32.dll d’Outlook) sans passer par la bibliothèque MAPI et le stub MAPI Windows. Pour plus d’informations sur la liaison explicite par rapport à la liaison implicite, consultez Lier aux fonctions MAPI.
La bibliothèque de stubs MAPI, publiée sur MAPIStubLibrary sur GitHub, remplace mapi32.lib et prend en charge la création d’applications MAPI 32 bits et 64 bits.
Prise en charge de Microsoft Outlook 64 bits : les rubriques de référence relatives aux éléments d’API applicables ont été mises à jour pour correspondre aux nouveaux fichiers d’en-tête qui prennent en charge Outlook 64 bits. Ces fichiers d’en-tête sont disponibles dans MAPIStubLibrary. Un nouvel exemple de code a été fourni dans Vérifier la version d’Outlook pour montrer comment case activée si la version installée d’Outlook est Microsoft Outlook 2010 64 bits et a été révisée pour Outlook 2013. Si votre application MAPI 32 bits existante va s’exécuter sur un système d’exploitation 64 bits avec Outlook 64 bits installé, vous devez reconstruire votre application 32 bits en tant qu’application 64 bits. Pour plus d’informations sur la prise en charge de MAPI pour Outlook 64 bits, consultez Création d’applications MAPI sur des plateformes 32 bits et 64 bits.
Exemple de fournisseur de magasin de messages : l’exemple de fournisseur de magasin PST encapsulé a été précédemment mis à jour pour prendre en charge l’architecture 64 bits. La rubrique Initialisation d’un fournisseur de magasin PST encapsulé de l’exemple a maintenant été développée pour fournir des informations sur les « Chemins d’accès PST et Unicode encapsulés ».
Saisie semi-automatique Stream : la rubrique cache des surnoms, anciennement format de fichier Nk2, a été mise à jour pour refléter les modifications apportées à Outlook 2013 et Outlook 2010. Les informations telles que la liste de saisie semi-automatique, qui est la liste des noms qui s’affichent dans les zones d’édition À, Cc et Cci pendant qu’un utilisateur compose un e-mail, sont désormais enregistrées dans la Stream de saisie semi-automatique d’un message sur l’ordinateur local au lieu de l’enregistrer dans un fichier comme dans Outlook 2007.
Interaction avec le Stream autocomplétion
Chargement de l’Stream de saisie semi-automatique
Enregistrement de la Stream de saisie semi-automatique
Prise en charge de l’arrêt rapide pour les clients MAPI : les clients MAPI peuvent désormais lancer un arrêt rapide et demander au sous-système MAPI d’informer les fournisseurs chargés de réduire la perte de données résultant de l’arrêt rapide. Des interfaces supplémentaires ont été ajoutées pour que le client et le fournisseur prennent en charge l’arrêt rapide. Pour plus d’informations sur l’arrêt rapide, consultez Arrêt du client dans MAPI.
Stream structure pour les définitions de champs d’un élément Outlook : la documentation d’un flux binaire pour la propriété PidLidPropertyDefinitionStream a été ajoutée. Cette propriété spécifie les définitions de tous les champs personnalisés et des paramètres de liaison de données pour les champs intégrés d’un élément Outlook.
Remplacement du magasin personnel : les interfaces suivantes et leurs méthodes respectives ont été ajoutées pour prendre en charge le remplacement de la stratégie PSTDisableGrow des fournisseurs de magasin de fichiers de dossiers personnels ( PST) :
Utilisation de plusieurs comptes Exchange : la documentation de l’API de carnet d’adresses MAPI a été ajoutée. Cette API a été améliorée pour prendre en charge plusieurs comptes Exchange dans Microsoft Outlook 2010 et inclut désormais Microsoft Outlook 2013. R�soudre les adresses correctement avec plusieurs comptes Exchange, utilisez les nouvelles fonctions qui utilisent un contexte de compte afin que les appels vers le carnet d'adresses rechercher le compte Exchange appropri�.
Formats de fichiers MAPI : les informations de configuration MAPI ont été développées pour expliquer comment utiliser les chemins d’accès dans Inscription de services et de fournisseurs de services dans MapiSvc.inf.
Propriétés : les propriétés étiquetées suivantes ont été ajoutées en plus de la documentation relative aux 38 autres propriétés balisées et aux propriétés nommées précédemment ajoutées :
Constantes MAPI : les constantes MAPI consolidées ont été développées. Dans les versions précédentes, ils étaient distribués dans un certain nombre de rubriques, mais sont désormais collectés dans une seule rubrique pour faciliter leur découverte et leur utilisation. Ils ont également été étendus pour offrir une couverture plus étendue, y compris les sections suivantes :
Définitions des codes d’erreur du carnet d’adresses et du magasin de messages Exchange
Définitions des quotas en mode mise en cache de boîte aux lettres Exchange Server