ITnef::EncodeRecips
S’applique à : Outlook 2013 | Outlook 2016
Encode une vue pour la table de destinataires d’un message dans le flux de données TNEF (Encapsulation Format) Transport-Neutral pour le message.
HRESULT EncodeRecips(
ULONG ulFlags,
LPMAPITABLE lpRecipientTable
);
Paramètres
ulFlags
[in] R�serv� ; doit �tre �gal � z�ro.
lpRecipientTable
[in] Pointeur vers la table de destinataires pour laquelle la vue est encodée. Le paramètre lpRecipientTable peut être NULL.
Valeur renvoyée
S_OK
L’appel a réussi et a retourné la ou les valeurs attendues.
Remarques
Les fournisseurs de transport, les fournisseurs de magasins de messages et les passerelles appellent la méthode ITnef ::EncodeRecips pour effectuer l’encodage TNEF pour une vue de table de destinataire particulière. L’encodage TNEF est utile, par exemple, si un fournisseur ou une passerelle nécessite un jeu de colonnes particulier, un ordre de tri ou une restriction pour la table de destinataires.
Un fournisseur ou une passerelle transmet la vue table pour qu’elle soit encodée dans le paramètre lpRecipientTable . L’implémentation TNEF encode la table de destinataires avec la vue donnée, à l’aide de l’ensemble de colonnes, de l’ordre de tri, de la restriction et de la position donnés. Si un fournisseur ou une passerelle transmet la valeur NULL dans lpRecipientTable, TNEF obtient la table des destinataires à partir du message encodé à l’aide de la méthode IMessage ::GetRecipientTable et traite chaque ligne de la table dans le flux TNEF à l’aide des paramètres actuels de la table.
L’appel de EncodeRecips avec NULL dans lpRecipientTable encode donc tous les destinataires du message et équivaut à appeler la méthode ITnef ::AddProps avec l’indicateur TNEF_PROP_INCLUDE dans son paramètre ulFlags et la propriété PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) dans son paramètre lpPropList .
Notez qu’il est rarement nécessaire d’appeler EncodeRecips , sauf s’il est nécessaire d’encoder une vue de table de destinataire particulière. Les systèmes de messagerie étrangers disposent presque toujours de fonctionnalités de gestion des listes de destinataires suffisamment puissantes pour répondre aux besoins courants de l’encodage des listes de destinataires ; par conséquent, ces systèmes n’ont presque jamais besoin de TNEF à cet effet.