Platform SDK: Exchange Server

HrMAPIGetFirstSRowSet

The HrMAPIGetFirstSRowSet function obtains the first MAPI SRowSet structure from an array of SRowSet structures.

Quick Info

Header file: EDKMAPI.H
Library: EDKMAPI.LIB

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

Parameters

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

Return Values

See Return Values.

Remarks

For more information on this function, see the HrMAPIGetFirstSRowSet 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, and SRowSet structure, see the MAPI Programmer's Reference.

See Also

HrMAPIGetNextSRowSet, HrMAPIGotoFirstSRow