LB_INITSTORAGE iletisi

Liste kutusu öğelerini depolamak için bellek ayırır. Bu ileti, bir uygulama liste kutusuna çok sayıda öğe eklemeden önce kullanılabilir.

Parametreler

wParam

Yer ayıracak madde sayısı.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : wParam parametresi 16 bit değerlerle sınırlıdır. Bu, liste kutularının 32.767'den fazla öğe içeremeyeceği anlamına gelir. Öğe sayısı kısıtlanmış olsa da, liste kutusundaki öğelerin bayt cinsinden toplam boyutu yalnızca kullanılabilir bellekle sınırlıdır.

lParam

Öğe dizeleri için ayrılacak bayt cinsinden ek bellek miktarı.

Dönüş değeri

İleti başarılı olursa, dönüş değeri, bellek yeniden konumlandırma gerekmeden önce liste kutusunun depolayabileceğiniz toplam öğe sayısıdır.

İleti başarısız olursa dönüş değeri LB_ERRSPACE.

Microsoft Windows NT 4.0 : Bu ileti belirtilen bellek miktarını ayırmaz; ancak, her zaman wParam parametresinde belirtilen değeri döndürür.

Açıklamalar

LB_INITSTORAGE iletisi, çok sayıda öğe (100'den fazla) içeren liste kutularının başlatılmasını hızlandırmaya yardımcı olur. Belirtilen bellek miktarını ayırarak sonraki LB_ADDSTRING, LB_INSERTSTRING, LB_DIR ve LB_ADDFILE iletilerinin daha verimli olması sağlanır. wParam ve lParam parametreleri için tahminleri kullanabilirsiniz. Fazla tahmin yaparsanız, ek bellek ayrılmış olarak kalır; hafife alırsanız, liste kutusu gerektiğinde ek bellek ayırır.

Bir dizeyi depolamak için gereken bellek null sonlandırıcıyı içerir. Bu nedenle, her biri 10 karakter uzunluğunda 100 dize eklemeyi planlıyorsanız, 100 wParam ve 100 × lParam (10 + 1) × sizeof(TCHAR) geçirirsiniz.

Gereksinimler

Gereksinim	Değer
Desteklenen en düşük düzeydeki istemci	Windows Vista [yalnızca masaüstü uygulamaları]
Desteklenen en düşük sunucu	Windows Server 2003 [yalnızca masaüstü uygulamaları]
Header	Winuser.h (Windows.h dahil)

Ayrıca bakınız

Referans

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING