CHStringArray class
[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 following table lists the CHStringArray methods and operators.
CHStringArray has these types of members:
Constructors
The CHStringArray class has these constructors.| Constructor | Description |
|---|---|
| CHStringArray | Constructs an empty array for CHString objects. |
Methods
The CHStringArray class has these methods.| Method | Description |
|---|---|
| Add | Adds an element to the end of the array; the array grows if necessary. |
| Append | Appends another array to the array; the array grows if necessary. |
| Copy | Copies another array to the array; the array grows if necessary. |
| ElementAt | Returns a temporary reference to the element pointer within the array. |
| FreeExtra | Frees all unused memory above the current upper bound. |
| GetAt | Returns the value at a given index. |
| GetData | Allows access to elements in the array. The value can be NULL. |
| GetSize | Gets the number of elements in the array. |
| GetUpperBound | Returns the largest valid index. |
| InsertAt | Overloaded. Inserts an element (or all of the elements in another array) at a specified index. |
| Operator [] | Sets or gets the element at the specified index. |
| RemoveAll | Removes all of the elements from this array. |
| RemoveAt | Removes an element at a specific index. |
| SetAt | Sets the value for a given index; the array is not allowed to grow. |
| SetAtGrow | Sets the value for a given index; the array grows if necessary. |
| SetSize | Sets the number of elements to be contained in this array |
Methods
The CHStringArray class has these methods.
| Method | Description |
|---|---|
| CHStringArray::Add | The Add method adds a new element to the end of an array, increasing the array by one. |
| CHStringArray::Append | The Append method adds the contents of another array to the end of the given array. |
| CHStringArray::CHStringArray | The CHStringArray constructor constructs an empty CHStringArray array. |
| CHStringArray::Copy | The Copy method overwrites the elements of the given array with the elements of another array. |
| CHStringArray::ElementAt | The ElementAt method returns a temporary reference to the element pointer within the array. |
| CHStringArray::FreeExtra | The FreeExtra method frees any extra memory allocated while the array increased. This method has no effect on the size or upper bound of the array. |
| CHStringArray::GetAt | Gets the array element at the specified index. |
| CHStringArray::GetData | The GetData method gains direct access to the elements in the array. |
| CHStringArray::GetSize | The GetSize method gets the size of the array. Because indexes are zero-based, the size is one greater than the largest index. |
| CHStringArray::GetUpperBound | The GetUpperBound method gets the current upper bound of an array. Because array indexes are zero-based, this function returns a value that is one less than GetSize. |
| CHStringArray::InsertAt | The InsertAt method inserts all of the elements of another CHStringArray array at the index specified by nStartIndex. |
| CHStringArray::RemoveAll | The RemoveAll method removes all the CHString members from this array. |
| CHStringArray::RemoveAt | The RemoveAt method removes one or more elements starting at a specified index in an array. |
| CHStringArray::SetAt | The SetAt method sets the array element at the specified index. |
| CHStringArray::SetAtGrow | Sets the array element at the specified index. |
| CHStringArray::SetSize | The SetSize method establishes the size of an empty or existing array. |
| CHStringArray::ElementAt | The ElementAt method returns a temporary reference to the element pointer within the array. |
| CHStringArray::InsertAt | The InsertAt method inserts an element (or multiple copies of an element) or all the elements of another array at a specified index. |
| CHStringArray::SetAt | The SetAt method sets the array element at the specified index. |
Requirements
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | chstrarr.h (include FwCommon.h) |