ADRENTRY

  • 项目

适用于：Outlook 2013 | Outlook 2016

描述属于收件人的零个或多个属性。

值 说明
标头文件：
 Mapidefs.h
 
typedef struct _ADRENTRY
{
  ULONG ulReserved1;
  ULONG cValues;
  LPSPropValue rgPropVals;
} ADRENTRY, FAR *LPADRENTRY;

Members

ulReserved1

保留;必须为零。

cValues

rgPropVals 成员指向的属性值数组中的属性计数。 cValues 成员可以为零。

rgPropVals

指向属性值数组的指针，该数组描述收件人的属性。 rgPropVals 成员可以为 NULL。

备注

ADRENTRY 结构描述属于单个收件人的属性。 通常用于描述收件人的属性包括：

PR_DISPLAY_NAME (PidTagDisplayName)

PR_ADDRTYPE (PidTagAddressType)

PR_EMAIL_ADDRESS (PidTagEmailAddress)

PR_ENTRYID (PidTagEntryId)

当收件人的 SPropValue 数组中出现条目标识符或PR_ENTRYID属性时，表示收件人已解析。 客户端调用 IAddrBook：：ResolveName 方法，以确保已解析传出邮件的收件人列表中的所有收件人。 只有已解析的收件人才能随邮件一起发送。

ADRENTRY 结构通常组合在一起，形成 ADRLIST 结构的 aEntries 成员的数组。

ADRENTRY 结构和 SRow 结构是相同的，因为它们都包含保留成员、属性值数组和数组中的值计数。 ADRENTRY 结构组合成 ADRLIST 结构的 aEntries 成员，而 SRow 结构则组合成 SRowSet 结构的 aRow 成员。 这两种类型的结构遵循相同的分配规则，这意味着从通讯簿容器的内容表中检索的 SRowSet 结构可以强制转换为 ADRLIST 结构，并按原样使用。

ADRENTRY 结构可以为空。 例如，在删除收件人时，在 IAddrBook：：Address 调用中 lppAdrList 参数指向的 ADRLIST 结构中包含的 ADRENTRY 结构可能为空。

有关如何为 ADRENTRY 结构分配内存的详细信息，请参阅 管理 ADRLIST 的内存和 SRowSet 结构。

另请参阅

IAddrBook::Address
IMessage::ModifyRecipients
MAPIAllocateBuffer
ADRLIST
SRow
SRowSetMAPI 结构