LB_INITSTORAGE pesan

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

Parameter

wParam

Jumlah item yang akan ditambahkan.

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, dalam byte, untuk dialokasikan untuk string item.

Nilai kembali

Jika pesan berhasil, nilai yang dikembalikan adalah jumlah total item yang memorinya telah dialokasikan sebelumnya, yaitu, jumlah total item yang ditambahkan oleh semua pesan LB_INITSTORAGE yang berhasil.

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 .

Keterangan

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 membutuhkan waktu sesingkat mungkin. Anda dapat menggunakan perkiraan untuk parameter wParam dan lParam . Jika Anda terlalu berlebihan, memori tambahan dialokasikan; jika Anda meremehkan, alokasi normal digunakan untuk item yang melebihi jumlah yang diminta.

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