ITnef::EncodeRecips
适用于：Outlook 2013 | Outlook 2016
将邮件的收件人表的视图编码为 Transport-Neutral 封装格式 (TNEF) 消息的数据流。
HRESULT EncodeRecips(
ULONG ulFlags,
LPMAPITABLE lpRecipientTable
);
参数
ulFlags
[in]保留;必须为零。
lpRecipientTable
[in]指向为其编码视图的收件人表的指针。 lpRecipientTable 参数可以为 NULL。
返回值
S_OK
调用成功并返回了一个或多个预期值。
备注
传输提供程序、消息存储提供程序和网关调用 ITnef：：EncodeRecips 方法，以对特定的收件人表视图执行 TNEF 编码。 例如，当提供程序或网关需要收件人表的特定列集、排序顺序或限制时，TNEF 编码非常有用。
提供程序或网关传递表视图，以 在 lpRecipientTable 参数中编码。 TNEF 实现使用给定列集、排序顺序、限制和位置，使用给定视图对收件人表进行编码。 如果提供程序或网关在 lpRecipientTable 中传递 NULL，则 TNEF 从使用 IMessage：：GetRecipientTable 方法编码的邮件中获取收件人表，并使用表的当前设置将表的每一行处理到 TNEF 流中。
因此，调用 lpRecipientTable 中为 NULL 的 EncodeRecips 对所有邮件收件人进行编码，等效于调用 ITnef：：AddProps 方法，其 ulFlags 参数中具有 TNEF_PROP_INCLUDE 标志，在其 lpPropList 参数中使用 PR_MESSAGE_RECIPIENTS (PidTagMessageRecipients) 属性。
请注意，除非要求对特定的收件人表视图进行编码，否则很少需要调用 EncodeRecips 。 外国消息传送系统几乎总是有处理收件人列表的工具，这些设施的功能足以处理对收件人列表进行编码的常见需求：因此，这些系统几乎从不需要 TNEF 来达到此目的。