ADRENTRY

Send Feedback

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 property value array describing the properties for the recipient; 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 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.

Requirements

Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h

See Also

IMessage::ModifyRecipients | MAPIAllocateBuffer | MAPI Structures | Messaging | SRow

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.