Implémentation d’une fonction de point d’entrée de fournisseur de carnet d’adresses
S’applique à : Outlook 2013 | Outlook 2016
Lorsqu’une application cliente appelle MAPILogonEx pour commencer une session à l’aide d’un profil qui contient votre fournisseur de carnet d’adresses, MAPI charge votre fournisseur et tous les autres éléments qui font partie du profil. MAPI apprend le nom de la fonction de point d’entrée de votre fournisseur en examinant le profil. N’oubliez pas que cette fonction n’est pas identique à une fonction de point d’entrée DLL ; consultez la documentation de DllMain dans la documentation Win32.
Il existe plusieurs entrées, dont certaines doivent apparaître dans le fichier de configuration mapisvc.inf, qui sont incluses dans la section profil de chaque fournisseur de carnet d’adresses. Le tableau suivant répertorie ces entrées de section de profil et indique si le fichier mapisvc.inf doit les inclure ou non.
Entrée de section de profil | Condition requise pour mapisvc.inf |
---|---|
PR_DISPLAY_NAME= chaîne |
Facultatif |
chaîne PR_PROVIDER_DISPLAY= |
Obligatoire |
nom de fichier DLL PR_PROVIDER_DLL_NAME= |
Obligatoire |
PR_RESOURCE_TYPE= long |
Obligatoire |
PR_RESOURCE_FLAGS= masque de bits |
Facultatif |
Votre fournisseur de carnet d’adresses peut placer ces informations dans un profil directement en appelant la méthode IMAPIProp ::SetProps de sa section de profil ou indirectement en modifiant MAPISVC.INF. Les profils sont créés à l’aide des informations pertinentes dans MAPISVC. INF pour les fournisseurs de services ou services de messagerie sélectionnés. Pour plus d’informations sur la organization et le contenu de MAPISVC. INF, consultez Format de fichier de MapiSvc.inf.
Le nom de la fonction de point d’entrée DLL de votre fournisseur d’adresses doit être ABProviderInit et doit être conforme au prototype ABProviderInit . Effectuez les tâches suivantes dans la fonction de point d’entrée DLL de votre fournisseur :
Vérifiez la version de l’interface spi (Service Provider Interface) pour vous assurer que MAPI utilise une version compatible avec la version utilisée par votre fournisseur de carnets d’adresses.
Instanciez un objet fournisseur de carnet d’adresses.
N’appelez pas MAPIInitialize ou MAPIUninitialize dans cette fonction.
La fonction point d’entrée DLL instancie un objet fournisseur et retourne à MAPI un pointeur vers cet objet.