HrMAPIGotoFirstSRow

The HrMAPIGotoFirstSRow function retrieves a pointer to the first MAPI SRow structure in a MAPI SRowSet structure.

Quick Info

Header file: EDKMAPI.H
Library: EDKMAPI.LIB 

HRESULT HrMAPIGotoFirstSRow(
  LPSRowSet FAR lpRows,  
  ULONG * lpulRow,       
  LPSRow * lppRow        
);

Parameters

lpRows
Input parameter. Points to the SRowSet structure.
lpulRow
Output parameter. Index of the SRow structure in the SRowSet structure.
lppRow
Output parameter. Points to a SRow structure.

Return Values

See Return Values.

Remarks

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

See Also

HrMAPIGetFirstSRowSet, HrMAPIGotoNextSRow, HrMAPIGotoSRow