IMessage::GetRecipientTable
S’applique à : Outlook 2013 | Outlook 2016
Retourne la table des destinataires du message.
HRESULT GetRecipientTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Paramètres
ulFlags
[in] Masque de bits des indicateurs qui contrôle le retour de la table. Les indicateurs suivants peuvent être définis :
MAPI_DEFERRED_ERRORS
Permet à GetRecipientTable de revenir correctement, éventuellement avant que la table ne soit entièrement disponible pour le client appelant. Si la table n’est pas disponible, un appel ultérieur à celle-ci peut entraîner une erreur.
MAPI_UNICODE
Les colonnes de chaîne doivent être au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les colonnes de chaîne doivent être au format ANSI.
lppTable
[out] Pointeur vers un pointeur vers la table de destinataires.
Valeur renvoyée
S_OK
La table de destinataires a été retournée avec succès.
Remarques
La méthode IMessage ::GetRecipientTable retourne un pointeur vers la table des destinataires du message, qui inclut des informations sur tous les destinataires du message. Il y a une ligne pour chaque destinataire.
Les tables de destinataires ont un ensemble de colonnes différent selon que le message a été envoyé ou non. Pour obtenir la liste complète des colonnes d’une table de destinataires, consultez Tables de destinataires.
Certaines tables de destinataires prennent en charge un large éventail de restrictions ; d’autres ne le font pas. La prise en charge des restrictions dépend de l’implémentation du fournisseur de magasin de messages.
La définition de l’indicateur MAPI_UNICODE dans le paramètre ulFlags affecte les appels suivants à la table de destinataires :
IMAPITable ::QueryColumns pour récupérer le jeu de colonnes.
IMAPITable ::QueryRows pour récupérer des lignes.
IMAPITable ::QuerySortOrder pour récupérer l’ordre de tri.
La définition de l’indicateur Unicode demande que les informations relatives aux colonnes de chaîne retournées par ces appels soient au format Unicode. Toutefois, étant donné que tous les fournisseurs de magasins de messages ne prennent pas en charge Unicode, la définition de cet indicateur n’est qu’une requête.
Remarques pour les appelants
Vous pouvez modifier une table de destinataires lorsqu’elle est ouverte en appelant la méthode IMessage ::ModifyRecipients . ModifyRecipients ajoute des destinataires, supprime des destinataires ou modifie les propriétés du destinataire.