CHStringArray::SetSize 方法 (chstrarr.h)

[ CHStringArray 类是 WMI 提供程序框架的一部分,该框架现在被视为处于最终状态,对于影响这些库的非安全性相关问题,不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]

SetSize 方法建立空数组或现有数组的大小。

语法

void  throw(CHeap_Exception) SetSize(
  int nNewSize,
  int nGrowBy
);

参数

nNewSize

新数组大小(元素数)。 该值必须大于或等于 0 (零) 。

nGrowBy

需要增加大小时要分配的最小元素槽数。

返回值

此方法不返回值。

备注

SetSize 方法会根据需要分配内存。 如果新大小小于旧大小,则数组将被截断,并释放所有未使用的内存。 为提高效率,请在使用数组之前调用 SetSize 来设置数组的大小。 这样可以防止每次添加项时都重新分配和复制数组。

当数组增长时, nGrowBy 参数会影响内部内存分配。 它的使用永远不会影响 GetSizeGetUpperBound 报告的数组大小。

示例

请参阅 CHStringArray::GetData 的示例。

要求

要求
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 chstrarr.h (包括 FwCommon.h)
Library FrameDyn.lib
DLL FrameDynOS.dll;FrameDyn.dll

另请参阅

CHStringArray

CHStringArray::GetData

CHStringArray::GetSize

CHStringArray::GetUpperBound