FreeProws

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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