It is the application's responsibility to free all application-allocated memory associated with the container records, such as text strings.

If a specified record is currently inserted into the container, the record is not freed and the PMERR_RECORD_CURRENTLY_INSERTED error is set. Container records must be removed with the CM_REMOVERECORD message before the CM_FREERECORD message is used.

If the number of pointers to container records in the array exceeds the count of records to be freed, only the number of records in the cNumRecord parameter is freed. If either the pRecordArray or the cNumRecord parameter is invalid, the PMERR_INVALID_PARAMETERS error is set and no container records are freed.

If the PMERR_MEMORY_DEALLOCATION_ERR error occurs, any further processing is unreliable.