HrMAPIGotoFirstSRow

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

Quick Info

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