LB_INITSTORAGE message

Alloue de la mémoire pour le stockage des éléments de zone de liste. Ce message est utilisé avant qu’une application ajoute un grand nombre d’éléments à une zone de liste.

Paramètres

wParam

Nombre d’éléments à ajouter.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : le paramètre wParam est limité aux valeurs 16 bits. Cela signifie que les zones de liste ne peuvent pas contenir plus de 32 767 éléments. Bien que le nombre d’éléments soit limité, la taille totale en octets des éléments d’une zone de liste est limitée uniquement par la mémoire disponible.

lParam

Quantité de mémoire, en octets, à allouer aux chaînes d’éléments.

Valeur retournée

Si le message réussit, la valeur de retour est le nombre total d’éléments pour lesquels de la mémoire a été pré-allouée, c’est-à-dire le nombre total d’éléments ajoutés par tous les messages LB_INITSTORAGE réussis.

Si le message échoue, la valeur de retour est LB_ERRSPACE.

Microsoft Windows NT 4.0 : ce message n’alloue pas la quantité de mémoire spécifiée ; Toutefois, elle retourne toujours la valeur spécifiée dans le paramètre wParam .

Notes

Le message LB_INITSTORAGE permet d’accélérer l’initialisation des zones de liste contenant un grand nombre d’éléments (plus de 100). Il réserve la quantité de mémoire spécifiée afin que les messages LB_ADDSTRING, LB_INSERTSTRING, LB_DIR et LB_ADDFILE suivants prennent le plus de temps possible. Vous pouvez utiliser des estimations pour les paramètres wParam et lParam . Si vous surestiment, la mémoire supplémentaire est allouée ; si vous sous-estimez, l’allocation normale est utilisée pour les éléments qui dépassent le montant demandé.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	Winuser.h (inclure Windows.h)

Voir aussi

Référence

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING