HrMAPIGetNextSRowSet

The HrMAPIGetNextSRowSet function obtains the next MAPI SRowSet structure from an array of MAPI SRowSet structures.

Quick Info

Header file: EDKMAPI.H
Library: EDKMAPI.LIB 

HRESULT HrMAPIGetNextSRowSet(
  LPMAPITABLE lpTable,     
  ULONG cRows,             
  LPSPropTagArray rgPropTags,  
  LPSRowSet FAR * lppRows  
);

Parameters

lpTable
Input parameter. Points to a MAPI IMAPITable interface containing the table.
cRows
Input parameter. Count of number of rows in the MAPI SRowSet structure.
rgPropTags
Input parameter. Array of property tags.
lppRows
Output parameter. Points to address variable for the MAPI SRowSet structure.

Return Values

See Return Values.

Remarks

For more information on this function, see the HrMAPIGetNextSRowSet function in EDKMAPI.C under the EDKMAPI code sample in the Code Samples folder.

Note To release memory that you have allocated for a SRowSet structure, use the MAPI FreeProws function. If you use the MAPI MAPIFreeBuffer function, your application will leak memory.

For information on the FreeProws function, IMAPITable interface, MAPIFreeBuffer function, SRowSet structure, see the MAPI Programmer's Reference.

See Also

HrMAPIGetFirstSRowSet, HrMAPIGotoNextSRow