IMAPISupport::SetProviderUID
S’applique à : Outlook 2013 | Outlook 2016
Inscrit une structure MAPIUID qui représente de façon unique le fournisseur de services.
HRESULT SetProviderUID(
LPMAPIUID lpProviderID,
ULONG ulFlags
);
Paramètres
lpProviderID
[in] Pointeur vers la structure MAPIUID qui identifie le fournisseur de carnet d’adresses ou de magasin de messages.
ulFlags
Réservés au; doit être égal à zéro.
Valeur renvoyée
S_OK
La structure MAPIUID a été inscrite avec succès.
Remarques
La méthode IMAPISupport ::SetProviderUID est implémentée pour les objets de prise en charge du carnet d’adresses et du fournisseur de magasin de messages. Ces fournisseurs appellent SetProviderUID pour inscrire un identificateur unique décrit dans la structure MAPIUID pointée par lpProviderID. Les fournisseurs incluent cet identificateur dans tous les identificateurs d’entrée qu’ils créent.
MAPI utilise la structure MAPIUID lorsqu’il envoie des messages sortants au spouleur MAPI et pour déterminer le fournisseur approprié pour gérer les demandes des clients. Par exemple, lorsqu’un client appelle la méthode IMAPISession ::OpenEntry , MAPI examine la partie MAPIUID de l’identificateur d’entrée, la mappe au fournisseur qui l’a transmise à SetProviderUID et appelle l’OpenEntry de ce fournisseur.
Remarques pour les appelants
Appelez SetProviderUID au moment de l’ouverture de session pour inscrire votre structure MAPIUID . MAPI permet aux fournisseurs de carnets d’adresses et de magasins de messages d’inscrire plusieurs identificateurs. Lorsque vous effectuez plusieurs appels à SetProviderUID, il ajoute toujours la structure MAPIUID à l’ensemble de structures MAPIUID du fournisseur, même si le MAPIUID est un doublon. SetProviderUID ne peut pas supprimer un MAPIUID.