CHStringArray::SetSize 方法 (chstrarr.h)
[ CHStringArray 类是 WMI 提供程序框架的一部分,该框架现在被视为处于最终状态,对于影响这些库的非安全性相关问题,不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]
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 |
标头 | chstrarr.h (包括 FwCommon.h) |
Library | FrameDyn.lib |
DLL | FrameDynOS.dll;FrameDyn.dll |