Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The ADRENTRYstructure 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 SPropValuestructures that describe a recipient's property values; can be NULL.

Remarks

An ADRENTRYstructure describes properties belonging to a single recipient. The properties that are typically used to describe a recipient include PR_ADDRTYPEand PR_EMAIL_ADDRESS.

ADRENTRYstructures are commonly combined to form an array for the aEntriesmember of an ADRLISTstructure.

ADRENTRYstructures and SRowstructures are identical in that they both contain a reserved member, an array of property values, and a count of values in the array. Whereas ADRENTRYstructures are combined to form the aEntriesmember of an ADRLISTstructure, SRowstructures are combined to form the aRowmember of an SRowSetstructure. Both types of structures follow the same allocation rules, implying that an CbSRowSetstructure that is retrieved from the contents table of an address book container can be cast to an ADRLISTstructure 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