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 |