LB_INITSTORAGE mensagem

Aloca memória para armazenar itens da caixa de lista. Esta mensagem pode ser usada antes de uma aplicação adicionar um grande número de itens a uma caixa de lista.

Parâmetros

wParam

O número de itens para os quais reservar espaço.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): O parâmetro wParam está limitado a valores de 16 bits. Isto significa que as caixas de lista não podem conter mais de 32.767 itens. Embora o número de itens seja limitado, o tamanho total em bytes dos itens numa caixa de lista é limitado apenas pela memória disponível.

lParam

A quantidade de memória adicional, em bytes, para alocar para cadeias de itens.

Valor de retorno

Se a mensagem for bem-sucedida, o valor de retorno é o número total de itens que a caixa de lista pode armazenar antes de ser necessária uma realocação de memória.

Se a mensagem falhar, o valor de retorno é LB_ERRSPACE.

Microsoft Windows NT 4.0: Esta mensagem não aloca a quantidade de memória especificada; no entanto, devolve sempre o valor especificado no parâmetro wParam .

Observações

A mensagem LB_INITSTORAGE ajuda a acelerar a inicialização das caixas de lista que contêm um grande número de itens (mais de 100). Reserva a quantidade de memória especificada para que as mensagens subsequentes de LB_ADDSTRING, LB_INSERTSTRING, LB_DIR e LB_ADDFILE sejam mais eficientes. Pode usar estimativas para os parâmetros wParam e lParam . Se sobrestimar, a memória extra permanece alocada; Se subestimar, a caixa da lista aloca memória adicional conforme necessário.

A memória necessária para armazenar uma cadeia inclui o terminador nulo. Portanto, se planeia adicionar 100 cadeias, cada uma com um comprimento de 10 caracteres, passaria um wParam de 100 e um lParam de 100 × (10 + 1) × tamanho de (TCHAR).

Requerimentos

Requisito	Valor
Cliente mínimo suportado	Windows Vista [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado	Windows Server 2003 [apenas aplicações de ambiente de trabalho]
Header	Winuser.h (inclui Windows.h)

Consulte também

Referência

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING