LB_INITSTORAGE üzenet

Memóriát foglal le a listaelemek tárolásához. Ez az üzenet használható, mielőtt egy alkalmazás nagy számú elemet ad hozzá egy listamezőhöz.

Paraméterek

wParam

Azoknak az elemeknek a száma, amelyek számára helyet kell lefoglalni.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): A wParam paraméter 16 bites értékekre korlátozódik. Ez azt jelenti, hogy a listamezők legfeljebb 32 767 elemet tartalmazhatnak. Bár az elemek száma korlátozott, a listamező elemeinek bájtban megadott teljes méretét csak a rendelkezésre álló memória korlátozza.

lParam

Az elemsztringekhez lefoglalandó memória mennyisége bájtban.

Visszaadott érték

Ha az üzenet sikeres, a visszatérési érték azoknak az elemeknek a teljes száma, amelyeket a lista tárolhat, mielőtt memóriaáthelyezésre lenne szükség.

Ha az üzenet sikertelen, a visszatérési érték LB_ERRSPACE.

Microsoft Windows NT 4.0: Ez az üzenet nem foglalja le a megadott mennyiségű memóriát; azonban mindig a wParam paraméterben megadott értéket adja vissza.

Megjegyzések

A LB_INITSTORAGE üzenet felgyorsítja a nagy számú (több mint 100) elemből álló listamezők inicializálását. Fenntartja a megadott mennyiségű memóriát, hogy a későbbi LB_ADDSTRING, LB_INSERTSTRING, LB_DIR és LB_ADDFILE üzenetek hatékonyabbak legyenek. A wParam és az lParam paraméterek becsléseit használhatja. Ha túlbecsüli, a többletmemória lefoglalva marad; ha alábecsüli, a listamező szükség szerint további memóriát foglal le.

A sztring tárolásához szükséges memória tartalmazza a null terminátort. Ezért ha 100 sztringet szeretne hozzáadni, mindegyik 10 karakter hosszúságú, akkor egy 100-as wParam és egy 100 × (10 + 1) lParam × sizeof(TCHAR) értéket adna át.

Requirements

Követelmény	Érték
Minimálisan támogatott ügyfél	Windows Vista [csak asztali alkalmazások]
Minimálisan támogatott kiszolgáló	Windows Server 2003 [csak asztali alkalmazások]
Header	Winuser.h (a Windows.h is)

Lásd még

Utalás

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING