FreeProws
Applies to: Outlook 2013 | Outlook 2016
Destroys an SRowSet structure and frees associated memory, including memory allocated for all member arrays and structures.
| Property | Value |
|---|---|
| Header file: |
Mapiutil.h |
| Implemented by: |
MAPI |
| Called by: |
Client applications and service providers |
void FreeProws(
LPSRowSet prows
);
Parameters
prows
[in] Pointer to the SRowSet structure to be destroyed.
Return value
None.
Notes to callers
As part of its implementation of FreeProws, MAPI calls the MAPIFreeBuffer function to free every entry in the SRowSet structure before freeing the complete structure. Therefore all such entries must have followed the allocation rules for the SRowSet structure, using an individual MAPIAllocateBuffer call for each member array and structure.
For more information about allocating memory for ADRLIST and SRowSet structures, see Managing Memory for ADRLIST and SRowSet Structures.
MFCMAPI reference
For MFCMAPI sample code, see the following table.
| File | Function | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
DwThreadFuncLoadTable |
MFCMAPI uses the FreeProws method to free an SRowSet structure containing rows of the table being processed. |