IMessage::GetRecipientTable

适用于:Outlook 2013 | Outlook 2016

返回邮件的收件人表。

HRESULT GetRecipientTable(
  ULONG ulFlags,
  LPMAPITABLE FAR * lppTable
);

参数

ulFlags

[in]控制表返回的标志的位掩码。 可以设置以下标志:

MAPI_DEFERRED_ERRORS

允许 GetRecipientTable 成功返回,可能是在表对调用客户端完全可用之前。 如果该表不可用,则对其进行后续调用可能会导致错误。

MAPI_UNICODE

字符串列应采用 Unicode 格式。 如果未设置MAPI_UNICODE标志,则字符串列应采用 ANSI 格式。

lppTable

[out]指向指向收件人表的指针的指针。

返回值

S_OK

已成功返回收件人表。

备注

IMessage::GetRecipientTable 方法返回指向邮件收件人表的指针,其中包括有关邮件的所有收件人的信息。 每个收件人都有一行。

收件人表具有不同的列集,具体取决于是否已提交邮件。 有关收件人表中列的完整列表,请参阅 收件人表

某些收件人表支持多种限制;其他人没有。 对限制的支持取决于消息存储提供程序的实现。

ulFlags 参数中设置MAPI_UNICODE标志会影响对收件人表的以下调用:

设置 Unicode 标志会请求这些调用返回的任何字符串列的信息采用 Unicode 格式。 但是,由于并非所有消息存储提供程序都支持 Unicode,因此设置此标志只是一个请求。

给调用方的说明

可以通过调用 IMessage::ModifyRecipients 方法在收件人表打开时更改该表。 ModifyRecipients 添加收件人、删除收件人或修改收件人属性。

另请参阅

IMAPIProp::SaveChanges

IMAPITable::QueryRows

IMessage::ModifyRecipients

IMessage : IMAPIProp