SRow

The SRow structure describes a row from a table containing selected properties for a specific object.

Quick Info

typedef struct _SRow 
{ 
     ULONG         ulAdrEntryPad; 
     ULONG         cValues; 
     LPSPropValue  lpProps; 
} SRow, FAR *LPSRow; 
 

Members

ulAdrEntryPad

Padding bytes to properly align the property values pointed to by the lpProps member.

cValues

Count of property values pointed to by lpProps.

lpProps

Pointer to an array of SPropValue structures that describe the property values for the columns in the row.

Remarks

An SRow structure describes a row in a table. An SRow structure is included in the TABLE_NOTIFICATION structure that accompanies a table notification and is used in the following:

IAddrBook::GetSearchPath

IAddrBook::SetSearchPath

IMAPITable::QueryRows

IMAPITable::ExpandRow

ITableData (many methods)

FBadRowSet

FreeProws

HrQueryAllRows

When more than one row needs to be described, an SRowSet structure is used. An SRowSet structure contains an array of SRow structures and a count of structures in the array.

The following illustration shows the relationship between an SRow and an SRowSet data structure.

SRow structures are defined the same as ADRENTRY structures so that a row of a recipient table and an entry in an address list can be treated the same. For information about how the memory for SRow structures should be allocated, see Managing Memory for ADRLIST and SRowSet Structures.

See Also

Table Structures, ITableData::HrQueryRow, TABLE_NOTIFICATION,

SPropValue, SRowSet