CHStringArray::SetAtGrow method

[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 SetAtGrow method sets the array element at the specified index. The array increases automatically if necessary, adjusting the upper bound to accommodate the new element.

Syntax


void SetAtGrow(
   int     nIndex,
   LPCWSTR newElement
) throw (CHeap_Exception);

Parameters

nIndex

An integer index that is greater than or equal to zero (0).

Note  The nIndex parameter must be greater than or equal to zero (0). The debug version of the CHStringArray library validates the bounds of nIndex; the release version does not.
 
newElement

The object pointer to be added to this array. A NULL value is allowed.

Return value

This method does not return a value.

Examples

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


CHStringArray array;

array.Add( L"String 1" ); // Element 0
array.Add( L"String 2" ); // Element 1
array.SetAtGrow( 3, L"String 3" ); // Element 2 deliberately skipped.

The results from this program are as follows.


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

Requirements

Minimum supported client

Windows Vista

Minimum supported server

Windows Server 2008

Header

ChStrArr.h (include FwCommon.h)

Library

FrameDyn.lib

DLL

FrameDynOS.dll;
FrameDyn.dll

See also

CHStringArray
CHStringArray::SetAt
CHStringArray::operator []

 

 

Show: