messaggio LB_INITSTORAGE

Alloca memoria per archiviare gli elementi della casella di riepilogo. Questo messaggio viene usato prima che un'applicazione aggiunge un numero elevato di elementi a una casella di riepilogo.

Parametri

wParam

Numero di elementi da aggiungere.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me): il parametro wParam è limitato a valori a 16 bit. Ciò significa che le caselle di riepilogo non possono contenere più di 32.767 elementi. Anche se il numero di elementi è limitato, la dimensione totale in byte degli elementi in una casella di riepilogo è limitata solo dalla memoria disponibile.

lParam

Quantità di memoria, in byte, da allocare per le stringhe di elementi.

Valore restituito

Se il messaggio ha esito positivo, il valore restituito è il numero totale di elementi per cui è stata pre-allocata la memoria, ovvero il numero totale di elementi aggiunti da tutti i messaggi di LB_INITSTORAGE riusciti.

Se il messaggio ha esito negativo, il valore restituito è LB_ERRSPACE.

Microsoft Windows NT 4.0: questo messaggio non alloca la quantità di memoria specificata; tuttavia, restituisce sempre il valore specificato nel parametro wParam .

Commenti

Il messaggio LB_INITSTORAGE consente di velocizzare l'inizializzazione delle caselle di riepilogo con un numero elevato di elementi (più di 100). Riserva la quantità di memoria specificata in modo che i LB_ADDSTRING successivi,LB_INSERTSTRING, LB_DIRe i messaggi LB_ADDFILE richiedono il tempo più breve possibile. È possibile usare stime per i parametri wParam e lParam . Se si sovrastima, la memoria aggiuntiva viene allocata; se si sottovaluta, la normale allocazione viene usata per gli elementi che superano l'importo richiesto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	Winuser.h (include Windows.h)

Vedi anche

Riferimento

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING