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:
-
ITableData : IUnknown (many methods)
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
.gif "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.