IAddrBook::PrepareRecips
S’applique à : Outlook 2013 | Outlook 2016
Prépare une liste de destinataires pour une utilisation ultérieure par le système de messagerie.
HRESULT PrepareRecips(
ULONG ulFlags,
LPSPropTagArray lpSPropTagArray,
LPADRLIST lpRecipList
);
Paramètres
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont l’entrée est ouverte. L’indicateur suivant peut être défini :
MAPI_CACHE_ONLY
Utilisez uniquement le carnet d’adresses en mode hors connexion pour effectuer la résolution de noms. Par exemple, vous pouvez utiliser cet indicateur pour permettre à une application cliente d’ouvrir la liste d’adresses globale (GAL) en mode d’échange mis en cache et d’accéder à une entrée de ce carnet d’adresses à partir du cache sans créer de trafic entre le client et le serveur. Cet indicateur est pris en charge uniquement par le fournisseur de carnets d’adresses Exchange.
lpSPropTagArray
[in] Pointeur vers une structure SPropTagArray qui contient un tableau de balises de propriété qui indiquent les propriétés, le cas échéant, qui nécessitent une mise à jour. Le paramètre lpSPropTagArray peut être NULL.
lpRecipList
[in] Pointeur vers une structure ADRLIST qui contient la liste des destinataires.
Valeur renvoyée
S_OK
La liste des destinataires a été préparée avec succès.
Remarques
Les clients et les fournisseurs de services appellent la méthode PrepareRecips pour effectuer les opérations suivantes :
Vérifiez que tous les destinataires du paramètre lpRecipList ont des identificateurs d’entrée à long terme.
Vérifiez que chaque destinataire du paramètre lpRecipList possède les propriétés répertoriées dans le paramètre lpSPropTagArray et que ces propriétés apparaissent au début de la liste des destinataires.
MAPI convertit les identificateurs d’entrée à court terme de chaque destinataire en identificateurs d’entrée à long terme. Si nécessaire, les identificateurs d’entrée à long terme des destinataires sont récupérés auprès du fournisseur de carnet d’adresses approprié et toutes les propriétés supplémentaires sont demandées.
Dans une entrée de destinataire individuelle, les propriétés demandées sont classées en premier, suivies des propriétés déjà présentes pour l’entrée. Si une ou plusieurs des propriétés demandées dans le paramètre lpSPropTagArray ne sont pas gérées par le fournisseur de carnet d’adresses approprié, leurs types de propriétés sont définis sur PT_ERROR. Leurs valeurs de propriété seront définies sur MAPI_E_NOT_FOUND ou sur une autre valeur qui donne une raison plus spécifique pour laquelle les propriétés ne sont pas disponibles. Chaque structure SPropValue incluse dans le paramètre lpRecipList doit être allouée séparément à l’aide des fonctions MAPIAllocateBuffer et MAPIAllocateMore afin qu’elle puisse être libérée individuellement.
Pour plus d’informations sur PT_ERROR, consultez Types de propriétés.