ADRENTRY

4/8/2010

The ADRENTRY structure describes zero or more properties belonging to a recipient.

Syntax

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

Members

  • ulReserved1
    Reserved; must be zero.
  • cValues
    Count of properties in the property value array pointed to by rgPropVals; can be zero.
  • rgPropVals
    Pointer to a an array of SPropValue structures that describe a recipient's property values; can be NULL.

Remarks

An ADRENTRY structure describes properties belonging to a single recipient. The properties that are typically used to describe a recipient include PR_ADDRTYPE and PR_EMAIL_ADDRESS.

ADRENTRY structures are commonly combined to form an array for the aEntries member of an ADRLIST structure.

ADRENTRY structures and SRow structures are identical in that 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 CbSRowSet structure that is retrieved from the contents table of an address book container can be cast to an ADRLIST structure and used as is.

Requirements

Header mapidefs.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Tasks

Sending a Message

Reference

IMessage::ModifyRecipients
MAPIAllocateBuffer
MAPI Structures
SRow

Other Resources

Messaging