Last modified: July 23, 2011
Applies to: Outlook
Describes zero or more properties that belong to a recipient.
An ADRENTRY structure describes properties that belong to a single recipient. The properties that are typically used to describe a recipient include the following:
When an entry identifier or PR_ENTRYID property appears in the SPropValue array for a recipient, this indicates that the recipient has been resolved. Clients call the IAddrBook::ResolveName method to make sure that all recipients in the recipient list of an outgoing message have been resolved. Only resolved recipients can be sent with messages.
ADRENTRY structures are typically combined to form an array for the aEntries member of an ADRLIST structure.
ADRENTRY structures and SRow structures are identical because they both contain a reserved member, an array of property values, and a count of values in the array. Whereas ADRENTRY structures are combined to form the aEntries member of an ADRLIST structure, SRow structures are combined to form the aRow member of an SRowSet structure. Both types of structures follow the same allocation rules, implying that an SRowSet structure that is retrieved from the contents table of an address book container can be cast to an ADRLIST structure and used as is.
An ADRENTRY structure can be empty. For example, an ADRENTRY structure that is contained in the ADRLIST structure pointed to by the lppAdrList parameter in a call to IAddrBook::Address can be empty when a recipient is being removed.
For more information about how to allocate memory for ADRENTRY structures, see Managing Memory for ADRLIST and SRowSet Structures.