The FIELDINFO structures are removed from the list of columns inserted into the container control.

If the CMA_FREE attribute is not specified, the container control removes the specified FIELDINFO structures without freeing the memory. The application is responsible for freeing the memory associated with the FIELDINFO structures by using the CM_FREEDETAILFIELDINFO message.

If the cNumFieldInfo parameter has a value of 0 and the CMA_FREE attribute is specified, all of the FIELDINFO structures in the container control are removed and the memory associated with the FIELDINFO structures is freed. It is the application's responsibility to free all of the application-allocated memory associated with the FIELDINFO structures.

If the number of pointers to FIELDINFO structures in the array exceeds the count of FIELDINFO structures to be removed, only the number of structures specified in the cNumFieldInfo parameter are removed. If the CCS_VERIFYPOINTERS style bit is set and the pFieldInfoArray parameter contains pointers to a FIELDINFO structure or structures that do not exist, the PMERR_INVALID_PARAMETERS error is set.

If you do not want to show a column, you can hide it by setting the CFA_INVISIBLE attribute of the FIELDINFO data structure and notifying the container control with the CM_INVALIDATEDETAILFIELDINFO message.

If the CMA_INVALIDATE attribute is specified, the container is repainted.