FreeProws

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Destroys an SRowSet structure and frees associated memory, including memory allocated for all member arrays and structures.

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.

See Also

Concepts

MFCMAPI as a Code Sample