CHStringArray::SetAt(int,LPCWSTR) method (chstrarr.h)

Article
08/19/2022

[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 SetAt method sets the array element at the specified index.

Syntax

void SetAt(
  int     nIndex,
  LPCWSTR newElement
);

Parameters

nIndex

An integer index that is greater than or equal to zero and less than or equal to the value returned by GetUpperBound.

newElement

The object pointer that is inserted in this array. A NULL value is allowed.

Return value

None

Remarks

The SetAt method does not cause the array to increase. Use SetAtGrow if you want the array to increase automatically.

You must ensure that your index value represents a valid position in the array.

Examples

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

CHStringArray array;

array.Add( L"String 1" ); // Element 0
array.Add( L"String 2" ); // Element 1
array.SetAt( 0, L"String 3" );  // Replace element 0.
assert( array[0] == "String 3" );

The following example results in a CHStringArray with two elements.

    [0] = String 3
    [1] = String 2

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