LB_INITSTORAGE zpráva

Přidělí paměť pro ukládání položek seznamu. Tuto zprávu lze použít předtím, než aplikace přidá do seznamu velký počet položek.

Parametry

wParam

Počet položek, pro které chcete rezervovat místo.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): Parametr wParam je omezen na 16bitové hodnoty. To znamená, že seznamy nesmí obsahovat více než 32 767 položek. I když je počet položek omezený, celková velikost v bajtech položek v seznamu je omezená pouze dostupnou pamětí.

lParam

Množství další paměti v bajtech, které se má přidělit pro řetězce položek.

Návratová hodnota

Pokud je zpráva úspěšná, návratová hodnota je celkový počet položek, které může seznam uložit před potřebou reallokace paměti.

Pokud zpráva selže, návratová hodnota se LB_ERRSPACE.

Microsoft Windows NT 4.0 : Tato zpráva nepřiděluje zadanou velikost paměti; ale vždy vrátí hodnotu zadanou v parametru wParam .

Poznámky

Zpráva LB_INITSTORAGE pomáhá urychlit inicializaci seznamů s velkým počtem položek (více než 100). Zarezervuje zadanou velikost paměti, aby následné LB_ADDSTRING, LB_INSERTSTRING, LB_DIR a LB_ADDFILE zprávy byly efektivnější. Pro parametry wParam a lParam můžete použít odhady. Pokud nadlimitujete, zůstane nadbytečná paměť přidělena; pokud podceňujete, seznam podle potřeby přidělí další paměť.

Paměť potřebná k uložení řetězce zahrnuje ukončovací znak null. Proto pokud plánujete přidat 100 řetězců, každý s délkou 10 znaků, předáte wParam 100 a lParam 100 × (10 + 1) × velikost (TCHAR).

Požadavky

Požadavek	Hodnota
Minimální podporovaný klient	Windows Vista [pouze desktopové aplikace]
Minimální podporovaný server	Windows Server 2003 [pouze desktopové aplikace]
Header	Winuser.h (včetně Windows.h)

Viz také

Odkaz

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING