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