Partilhar via


LB_INITSTORAGE mensagem

Aloca memória para armazenar itens de caixa de listagem. Essa mensagem é usada antes que um aplicativo adicione um grande número de itens a uma caixa de listagem.

Parâmetros

wParam

O número de itens a serem adicionados.

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

lParam

A quantidade de memória, em bytes, a ser alocada para cadeias de caracteres de item.

Valor retornado

Se a mensagem for bem-sucedida, o valor retornado será o número total de itens para os quais a memória foi pré-alocada, ou seja, o número total de itens adicionados por todas as mensagens de LB_INITSTORAGE bem-sucedidas.

Se a mensagem falhar, o valor retornado será LB_ERRSPACE.

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

Comentários

A mensagem LB_INITSTORAGE ajuda a acelerar a inicialização das caixas de listagem que têm um grande número de itens (mais de 100). Ele reserva a quantidade de memória especificada para que as mensagens LB_ADDSTRING, LB_INSERTSTRING, LB_DIR e LB_ADDFILE subsequentes levem o menor tempo possível. Você pode usar estimativas para os parâmetros wParam e lParam . Se você superestimar, a memória extra será alocada; se você subestimar, a alocação normal será usada para itens que excedem o valor solicitado.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Winuser.h (inclua Windows.h)

Confira também

Referência

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING