Does the ListView_InsertGroup Win32 API make a deep copy of the LVGROUP::pszHeader member?

Question

Does the ListView_InsertGroup Win32 API make a deep copy of the LVGROUP::pszHeader member? The documentation for ListView_InsertGroup or LVGROUP does not state this, nor does it state what is the required lifetime of the buffer holding the LVGROUP::pszHeader member. I need to know whether the buffer containing the LVGROUP::pszHeader bytes needs to outlive the ListView_InsertGroup call.

Note that the header strings are not literals, but are loaded from a file and cannot be hard-coded.

Answer 1

The List View control makes a copy of the string whose address is assigned to the LVGROUP pszHeader member.

You can empirically determine this is the case by using a debugger to change the string value pointed to by pszHeader during execution. If the List View control only stored the pointer value then those subsequent changes would be reflected in the control during execution, but they are not.

Answer 2

The ListView_InsertGroup function in the Win32 API does not perform a deep copy of the LVGROUP::pszHeader member. It stores the pointer to the string as provided in the LVGROUP structure. Therefore, the memory holding the pszHeader string must be valid for as long as the group is present in the list view.