SRowSet
4/8/2010
The SRowSet structure contains an array of SRow structures, each SRow structure describing a row from a table.
Syntax
struct {
ULONG cRows;
SRow aRow[MAPI_DIM];
} SRowSet, FAR *LPSRowSet;
Members
- cRows
Count of SRow structures in aRow.
- aRow
Array of SRow structures, one for each row in the table.
Remarks
An SRowSet structure is used to describe multiple rows of data from a table. SRowSet structures are used in the IMAPITable interface methods, such as QueryRows, and in the FreeProws function.
Each SPropValue structure in the array pointed to by the lpProps member of each row in the row set must be allocated separately by using MAPIAllocateBuffer. Each property value structure also must be deallocated by using MAPIFreeBuffer prior to the deallocation of its SRowSet structure so that pointers to the allocated SPropValue structures are not lost. A row's allocated memory can then be preserved and reused outside the context of the SRowSet structure.
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
Reference
MAPI Structures
CbNewSRowSet
CbSRowSet
SizedSRowSet