message LB_INITSTORAGE

Alloue de la mémoire pour stocker les éléments de zone de liste. Ce message peut être utilisé avant qu’une application ajoute un grand nombre d’éléments à une zone de liste.

Paramètres

wParam

Nombre d’éléments pour lesquels réserver de l’espace.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : le paramètre wParam est limité à des 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 supplémentaire, en octets, à allouer pour les chaînes d’élément.

Valeur retournée

Si le message réussit, la valeur de retour correspond au nombre total d’éléments que la zone de liste peut stocker avant qu’une réaffectation de mémoire soit nécessaire.

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 .

Remarques

Le message LB_INITSTORAGE permet d’accélérer l’initialisation des zones de liste qui ont un grand nombre d’éléments (plus de 100). Elle réserve la quantité de mémoire spécifiée afin que les messages suivants LB_ADDSTRING, LB_INSERTSTRING, LB_DIR et LB_ADDFILE soient plus efficaces. Vous pouvez utiliser des estimations pour les paramètres wParam et lParam . Si vous surestimatez, la mémoire supplémentaire reste allouée ; si vous sous-estimez, la zone de liste alloue une mémoire supplémentaire si nécessaire.

La mémoire requise pour stocker une chaîne inclut le terminateur Null. Par conséquent, si vous envisagez d’ajouter 100 chaînes, chacune avec une longueur de 10 caractères, vous passez un wParam de 100 et un lParam de 100 × (10 + 1) × sizeof(TCHAR).

Spécifications

Voir aussi

Référence

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING