It is the application's responsibility to free all application-allocated memory associated with the structures, such as user data.

If a specified FIELDINFO structure is currently inserted into the container, the structure is not freed and the PMERR_FI_CURRENTLY_INSERTED error is set. FIELDINFO structures must be removed with the CM_REMOVEDETAILFIELDINFO message before the CM_FREEDETAILFIELDINFO message is used.

If the number of pointers to FIELDINFO structures in the array exceeds the count of structures to be freed, only the number of structures in the cNumFieldInfo parameter is freed. If either the pFieldInfoArray or the cNumFieldInfo parameter is invalid, the PMERR_INVALID_PARAMETERS error is set and no FIELDINFO structures are freed.

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


[Back] [Next]