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标志会影响对收件人表的以下调用:
用于检索列集的 IMAPITable::QueryColumns。
用于检索行的 IMAPITable::QueryRows。
用于检索排序顺序的 IMAPITable::QuerySortOrder。
设置 Unicode 标志会请求这些调用返回的任何字符串列的信息采用 Unicode 格式。 但是,由于并非所有消息存储提供程序都支持 Unicode,因此设置此标志只是一个请求。
给调用方的说明
可以通过调用 IMessage::ModifyRecipients 方法在收件人表打开时更改该表。 ModifyRecipients 添加收件人、删除收件人或修改收件人属性。