pesan LB_INITSTORAGE

Mengalokasikan memori untuk menyimpan item kotak daftar. Pesan ini dapat digunakan sebelum aplikasi menambahkan sejumlah besar item ke kotak daftar.

Parameter-parameternya

wParam

Jumlah item yang akan dipesan ruangnya.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : Parameter wParam dibatasi hingga nilai 16-bit. Ini berarti kotak daftar tidak boleh berisi lebih dari 32.767 item. Meskipun jumlah item dibatasi, ukuran total dalam byte item dalam kotak daftar hanya dibatasi oleh memori yang tersedia.

lParam

Jumlah memori tambahan, dalam byte, untuk mengalokasikan string item.

Mengembalikan nilai

Jika pesan berhasil, nilai yang dikembalikan adalah jumlah total item yang dapat disimpan kotak daftar sebelum realokasi memori diperlukan.

Jika pesan gagal, nilai yang dikembalikan adalah LB_ERRSPACE.

Microsoft Windows NT 4.0 : Pesan ini tidak mengalokasikan jumlah memori yang ditentukan; namun, selalu mengembalikan nilai yang ditentukan dalam parameter wParam .

Komentar

Pesan LB_INITSTORAGE membantu mempercepat inisialisasi kotak daftar yang memiliki sejumlah besar item (lebih dari 100). Ini mencadangkan jumlah memori yang ditentukan sehingga pesan LB_ADDSTRING, LB_INSERTSTRING, LB_DIR, dan LB_ADDFILE berikutnya lebih efisien. Anda dapat menggunakan perkiraan untuk parameter wParam dan lParam . Jika Anda berlebihan, memori tambahan tetap dialokasikan; jika Anda meremehkan, kotak daftar akan mengalokasikan memori tambahan seperlunya.

Memori yang diperlukan untuk menyimpan string mencakup terminator null. Oleh karena itu, jika Anda berencana untuk menambahkan 100 string, masing-masing dengan panjang 10 karakter, Anda akan melewati wParam 100 dan lParam 100 × (10 + 1) × sizeof (TCHAR).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING