Share via


LB_INITSTORAGE訊息

配置記憶體來儲存清單方塊專案。 此訊息會在應用程式將大量專案新增至清單方塊之前使用。

參數

wParam

要加入的專案數目。

Windows 95/Windows 98/Windows Premium Edition (Windows Me) : wParam 參數限制為 16 位值。 這表示清單方塊不能包含超過 32,767 個專案。 雖然專案數目受到限制,但清單方塊中專案的總大小以位元組為單位只會受限於可用的記憶體。

lParam

要配置給專案字串的記憶體數量,以位元組為單位。

傳回值

如果訊息成功,傳回值就是預先配置記憶體的專案總數,也就是所有成功 LB_INITSTORAGE 訊息所新增的專案總數。

如果訊息失敗,傳回值會LB_ERRSPACE。

Microsoft Windows NT 4.0:此訊息不會配置指定的記憶體數量;不過,它一律會傳回wParam參數中指定的值。

備註

LB_INITSTORAGE訊息有助於加速清單方塊的初始化,這些清單方塊 (超過 100 個) 。 它會保留指定的記憶體數量,讓後續 LB_ADDSTRINGLB_INSERTSTRINGLB_DIRLB_ADDFILE 訊息花費最短的時間。 您可以使用 wParamlParam 參數的估計值。 如果您超額,則會配置額外的記憶體;如果您忽略,則一般配置會用於超過要求金額的專案。

規格需求

需求
最低支援的用戶端
Windows Vista [僅限傳統型應用程式]
最低支援的伺服器
Windows Server 2003 [僅限傳統型應用程式]
標頭
Winuser.h (包含 Windows.h)

另請參閱

參考

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING