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 所報告的數位大小。