IMsgServiceAdmin::SetPrimaryIdentity
S’applique à : Outlook 2013 | Outlook 2016
Désigne un service de message comme fournisseur de l’identité principale du profil.
HRESULT SetPrimaryIdentity(
LPMAPIUID lpUID,
ULONG ulFlags
);
Paramètres
lpUID
[in] Pointeur vers la structure MAPIUID qui contient l’identificateur unique du service de message pour fournir l’identité principale, ou NULL, qui indique que SetPrimaryIdentity doit effacer l’identité actuelle.
ulFlags
[in] R�serv� ; doit �tre �gal � z�ro.
Valeur renvoyée
S_OK
Le service de message a reçu le fournisseur de l’identité principale.
MAPI_E_NO_ACCESS
SetPrimaryIdentity a tenté de désigner un service de message dont l’indicateur SERVICE_NO_PRIMARY_IDENTITY est défini dans sa propriété PR_RESOURCE_FLAGS (PidTagResourceFlags).
Remarques
La méthode IMsgServiceAdmin ::SetPrimaryIdentity établit un service de message en tant que fournisseur de l’identité principale pour le profil. L’identité principale est généralement l’utilisateur qui est connecté au service de messagerie. Il est représenté par trois propriétés :
PR_IDENTITY_DISPLAY (PidTagIdentityDisplay)
PR_IDENTITY_ENTRYID (PidTagIdentityEntryId)
PR_IDENTITY_SEARCH_KEY (PidTagIdentitySearchKey)
Chaque fournisseur de services dans le service de messagerie désigné définit ces trois propriétés sur le nom d’affichage, l’identificateur d’entrée et la clé de recherche de l’utilisateur de messagerie qui fournit l’identité principale. Les clients peuvent récupérer l’identificateur d’entrée de l’identité principale en appelant la méthode IMAPISession ::QueryIdentity .
La propriété PR_RESOURCE_FLAGS est définie sur STATUS_PRIMARY_IDENTITY pour chaque fournisseur membre du service de messagerie qui fournit l’identité principale, et sur SERVICE_PRIMARY_IDENTITY pour le service de message. Lorsqu’un fournisseur de services ne peut pas fournir l’identité principale de son service de messagerie, il définit PR_RESOURCE_FLAGS sur STATUS_NO_PRIMARY_IDENTITY. SetPrimaryIdentity définit la propriété PR_RESOURCE_FLAGS de chaque service de message qui ne fournit pas l’identité principale à SERVICE_NO_PRIMARY_IDENTITY.
Chaque fournisseur de services de messagerie sur lequel MAPI dispose d’informations peut établir une identité pour chacun de ses utilisateurs lorsqu’un client se connecte au service. Toutefois, étant donné que MAPI prend en charge les connexions à plusieurs fournisseurs de services pour chaque session MAPI, il n’existe aucune définition ferme de l’identité d’un utilisateur particulier pour la session MAPI dans son ensemble . L’identité d’un utilisateur dépend du service concerné. Les clients peuvent appeler SetPrimaryIdentity pour désigner l’une des nombreuses identités établies pour un utilisateur par les services de messagerie comme identité principale pour cet utilisateur.