Metode CHStringArray::SetSize (chstrarr.h)

[Kelas CHStringArray adalah bagian dari WMI Provider Framework yang sekarang dipertimbangkan dalam keadaan akhir, dan tidak ada pengembangan, peningkatan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]

Metode SetSize menetapkan ukuran array kosong atau yang sudah ada.

Sintaks

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

Parameter

nNewSize

Ukuran array baru (jumlah elemen). Nilai harus lebih besar dari atau sama dengan 0 (nol).

nGrowBy

Jumlah minimum slot elemen untuk dialokasikan jika peningkatan ukuran diperlukan.

Nilai kembali

Metode ini tidak mengembalikan nilai.

Keterangan

Metode SetSize mengalokasikan memori jika perlu. Jika ukuran baru lebih kecil dari ukuran lama, maka array dipotok, dan semua memori yang tidak digunakan dilepaskan. Untuk efisiensi, panggil SetSize untuk mengatur ukuran array sebelum menggunakannya. Ini mencegah kebutuhan untuk mengalokasikan ulang dan menyalin array setiap kali item ditambahkan.

Parameter nGrowBy memengaruhi alokasi memori internal saat array berkembang. Penggunaannya tidak pernah memengaruhi ukuran array seperti yang dilaporkan oleh GetSize dan GetUpperBound.

Contoh

Lihat contoh untuk CHStringArray::GetData.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	chstrarr.h (termasuk FwCommon.h)
Pustaka	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll

Lihat juga

CHStringArray

CHStringArray::GetData

CHStringArray::GetSize

CHStringArray::GetUpperBound