SRow

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 page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Describes a row from a table that contains selected properties for a specific object.

Header file:

Mapidefs.h

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. It is included in the TABLE_NOTIFICATION structure that accompanies a table notification.

SRow structures are used in the following methods:

-
IAddrBook::GetSearchPath

-
IAddrBook::SetSearchPath

-
IMAPITable::QueryRows

-
IMAPITable::ExpandRow

-
ITableData : IUnknown (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.

Relationship between SRow and SRowSet

SRow structures are defined the same as ADRENTRY structures. Therefore, 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

Reference

ADRENTRY

SPropValue

SRowSet

TABLE_NOTIFICATION

Concepts

MAPI Structures

Managing Memory for ADRLIST and SRowSet Structures