ADRENTRY

適用於：Outlook 2013 |Outlook 2016

描述屬於收件者的零個或多個屬性。

值	描述
標頭檔：	Mapidefs.h

typedef struct _ADRENTRY
{
  ULONG ulReserved1;
  ULONG cValues;
  LPSPropValue rgPropVals;
} ADRENTRY, FAR *LPADRENTRY;

成員

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 結構