LB_INITSTORAGE消息

分配用于存储列表框项的内存。 此消息在应用程序将大量项添加到列表框之前使用。

参数

wParam

要添加的项数。

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) ： wParam 参数限制为 16 位值。 这意味着列表框不能包含超过 32,767 个项。 尽管项数受到限制，但列表框中项的总大小（以字节为单位）仅受可用内存的限制。

lParam

要为项字符串分配的内存量（以字节为单位）。

返回值

如果消息成功，则返回值是已为其预分配内存的项总数，即所有成功 LB_INITSTORAGE 消息添加的项总数。

如果消息失败，则返回值LB_ERRSPACE。

Microsoft Windows NT 4.0：此消息不分配指定的内存量;但是，它始终返回 wParam 参数中指定的值。

备注

LB_INITSTORAGE消息有助于加快列表框的初始化速度，这些列表框具有大量项 (超过 100) 。 它保留指定的内存量，以便后续 LB_ADDSTRING、 LB_INSERTSTRING、 LB_DIR和 LB_ADDFILE 消息花费尽可能短的时间。 可以对 wParam 和 lParam 参数使用估算值。 如果高估，则会分配额外的内存;如果低估，则正常分配用于超出请求数量的项。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	Winuser.h (包括 Windows.h)

另请参阅

引用

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING