CHStringArray::Copy method (chstrarr.h)

Article
02/22/2024

[The CHStringArray class is part of the WMI Provider Framework which is now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.]

The Copy method overwrites the elements of the given array with the elements of another array.

Syntax

void  throw(CHeap_Exception) Copy(
  [ref] const CHStringArray & src
);

Parameters

[ref] src

Source of the elements to be copied to the array.

Return value

This method does not return a value.

Remarks

The Copy method does not free memory, but it allocates extra memory to accommodate the elements copied to the array.

Examples

The following code example shows the use of CHStringArray::Copy.

CHStringArray a1, a2;
int idx, size;

a1.Add( L"String 1" );
a1.Add( L"String 2" );
a2.Add( L"String 5" );

size = a1.GetSize();
for (idx=0; idx<size; idx++)
   printf("[%d]: %S\n", idx, a1[idx]);

a1.Copy(a2);
size = a1.GetSize();
for (idx=0; idx<size; idx++)
   printf("[%d]: %S\n", idx, a1[idx]);

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	chstrarr.h (include FwCommon.h)
Library	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll