Share via


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

Other Resources

Messaging