FreePadrlist

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 ADRLIST 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 FreePadrlist(
  LPADRLIST padrlist
);

Parameters

  • padrlist
    [in] Pointer to the ADRLIST structure to be destroyed.

Return Value

None.

Notes to Callers

As part of its implementation of FreePadrlist, MAPI calls the MAPIFreeBuffer function to free every entry in the ADRLIST structure before freeing the complete structure. Therefore all such entries must have followed the allocation rules for the ADRLIST 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

MAPIABFunctions.cpp

AddOneOffAddress

MFCMAPI uses the FreePadrlist method to free an ADRLIST structure that was built to add a one-off address to a message.

See Also

Concepts

MFCMAPI as a Code Sample