сообщение LB_INITSTORAGE

Выделяет память для хранения элементов списка. Это сообщение можно использовать перед добавлением большого количества элементов в поле списка.

Параметры

wParam

Количество элементов, для которых требуется зарезервировать пространство.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): параметр wParam ограничен 16-разрядными значениями. Это означает, что поля списков не могут содержать более 32 767 элементов. Хотя количество элементов ограничено, общий размер в байтах элементов в списке ограничен только доступной памятью.

lParam

Объем дополнительной памяти в байтах, выделяемой для строк элементов.

Возвращаемое значение

Если сообщение выполнено успешно, возвращаемое значение — общее количество элементов, которые может храниться в списке, прежде чем потребуется перемещение памяти.

Если сообщение завершается ошибкой, возвращаемое значение LB_ERRSPACE.

Microsoft Windows NT 4.0: это сообщение не выделяет указанный объем памяти; однако он всегда возвращает значение, указанное в параметре wParam .

Замечания

Сообщение LB_INITSTORAGE помогает ускорить инициализацию полей списка с большим количеством элементов (более 100). Он резервирует указанный объем памяти, чтобы последующие LB_ADDSTRING, LB_INSERTSTRING, LB_DIR и LB_ADDFILE сообщения были более эффективными. Вы можете использовать оценки для параметров wParam и lParam . Если вы переоцените, дополнительная память остается выделенной; Если вы недооцениваете, поле списка будет выделять дополнительную память по мере необходимости.

Память, необходимая для хранения строки, включает терминатор NULL. Таким образом, если планируется добавить 100 строк, каждая из которых имеет длину 10 символов, передайте wParam 100 и lParam из 100 × (10 + 1) × sizeof(TCHAR).

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows Vista [только классические приложения]
Минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
Header	Winuser.h (включая Windows.h)

См. также

Справочные материалы

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING