Partager via

Identité principale MAPI

  • Article

S’applique à : Outlook 2013 | Outlook 2016

La plupart des sessions MAPI ont un fournisseur de services particulier qui fournit l’identité principale pour la session. En règle générale, il s’agit d’un fournisseur de carnet d’adresses, qui fournit l’identité par le biais de l’un de ses objets utilisateur de messagerie ou de ses listes de distribution. En fait, MAPI recommande que les services de messagerie qui incluent un fournisseur de carnet d’adresses utilisent l’un de ses objets pour l’identité principale. Lorsqu’un fournisseur de services qui appartient à un service de messagerie fournit l’identité principale, tous les autres fournisseurs de services du service de messagerie partagent cette identité.

The MAPISVC. Le fichier de configuration INF contient des entrées relatives à l’identité au niveau du service de messagerie et du fournisseur de services. Les sections du service de messagerie doivent inclure une entrée qui indique si le service peut fournir l’identité principale ou non ; Les sections du fournisseur de services incluent une entrée similaire uniquement lorsque le fournisseur peut fournir une identité.

Le tableau suivant répertorie les entrées qui apparaissent dans les sections service de message et fournisseur de services dans MAPISVC. Fichier INF.

Fournisseur d’identité principal PR_RESOURCE_FLAGS paramètre
Service de message
 SERVICE_PRIMARY_IDENTITY
Pas le service de message
 SERVICE_NO_PRIMARY_IDENTITY
Fournisseur
 STATUS_PRIMARY_IDENTITY

Bien que plusieurs services de messagerie puissent déclarer leur capacité à fournir l’identité principale d’une session, un seul service de message est sélectionné pour le faire. Cette sélection peut se produire :

  • Lorsqu’un profil est créé.

  • Lorsqu’un client appelle IMsgServiceAdmin ::SetPrimaryIdentity pour établir explicitement un service de messagerie particulier en tant que fournisseur de l’identité de session. Pour plus d’informations. Consultez IMsgServiceAdmin ::SetPrimaryIdentity.

Lorsqu’un profil est créé, MAPI désigne le premier service de message à configurer qui inclut un fournisseur avec l’indicateur STATUS_PRIMARY_IDENTITY défini dans sa propriété PR_RESOURCE_FLAGS (PidTagResourceFlags) pour fournir l’identité principale. Dans le service de message désigné, le premier fournisseur à configurer avec cet indicateur de ressource est choisi pour fournir l’identité du service. L’indicateur STATUS_PRIMARY_IDENTITY est effacé pour tous les autres fournisseurs du service désigné et pour les autres services de messagerie dans le profil. Si, à un moment donné, le fournisseur fournissant l’identité principale est supprimé du profil, MAPI attribue le rôle au fournisseur suivant à configurer qui peut fournir l’identité. Cela est déterminé par l’apparence de l’entrée PR_RESOURCE_FLAGS=STATUS_PRIMARY_IDENTITY dans la section du fournisseur dans MAPISVC.INF.

Lorsqu’un client appelle la méthode IMsgServiceAdmin ::SetPrimaryIdentity d’un service de messagerie, il spécifie le MAPIUID pour un fournisseur de services au sein du service cible. Pour plus d’informations, consultez MAPIUID. Le fournisseur de services représenté par le MAPIUID est affecté pour fournir l’identité principale pour le service de messagerie et pour la session, et tous les autres fournisseurs du service partageront cette identité.

Chaque fournisseur du service de messagerie chargé de fournir l’identité principale met à jour sa ligne dans la table status pour inclure les propriétés suivantes.

Propriété d’identité principale Définition sur
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
 Nom d’affichage de l’objet qui fournit l’identité principale.
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
 Recherchez la clé de l’objet qui fournit l’identité primaire.
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
 Identificateur d’entrée pour l’objet qui fournit l’identité principale.

Pour récupérer l’identificateur d’entrée de l’objet fournissant l’identité principale

  • Appelez la méthode IMAPISession ::QueryIdentity . Pour plus d’informations, consultez IMAPISession ::QueryIdentity. QueryIdentity recherche dans la table status la ligne qui contient la valeur STATUS_PRIMARY_IDENTITY dans sa colonne PR_RESOURCE_FLAGS et retourne le PR_IDENTITY_ENTRYID correspondant comme identificateur d’entrée pour l’identité principale.