Share via


SRowSet

The SRowSet structure contains an array of SRow structures, each SRow structure describing a row from a table.

Syntax

typedef struct _SRowSet {
  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

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h

See Also

MAPI Structures

Messaging

Related Macros

CbNewSRowSet

CbSRowSet ****

SizedSRowSet

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.