Метод CHStringArray::SetSize (chstrarr.h)
[Класс CHStringArray является частью платформы поставщика WMI, которая теперь рассматривается в окончательном состоянии, и никакие дальнейшие разработки, улучшения или обновления не будут доступны для проблем, не связанных с безопасностью, влияющих на эти библиотеки. API mi mi следует использовать для всех новых разработок.]
Метод SetSize устанавливает размер пустого или существующего массива.
Синтаксис
void throw(CHeap_Exception) SetSize(
int nNewSize,
int nGrowBy
);
Параметры
nNewSize
Новый размер массива (количество элементов). Значение должно быть больше или равно 0 (нулю).
nGrowBy
Минимальное количество слотов элементов, выделяемых при необходимости увеличения размера.
Возвращаемое значение
Этот метод не возвращает значение.
Комментарии
При необходимости метод SetSize выделяет память. Если новый размер меньше старого, массив усекается и освобождается вся неиспользуемая память. Для повышения эффективности вызовите SetSize , чтобы задать размер массива перед его использованием. Это позволяет избежать необходимости повторного выделения и копирования массива при каждом добавлении элемента.
Параметр nGrowBy влияет на выделение внутренней памяти во время роста массива. Его использование никогда не влияет на размер массива, сообщаемый GetSize и GetUpperBound.
Примеры
См. пример для CHStringArray::GetData.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | chstrarr.h (включая FwCommon.h) |
| Библиотека | FrameDyn.lib |
| DLL | FrameDynOS.dll; FrameDyn.dll |