messaggio CB_INITSTORAGE

Un'applicazione invia il messaggio CB_INITSTORAGE prima di aggiungere un numero elevato di elementi alla parte casella di riepilogo di una casella combinata. Questo messaggio alloca memoria per l'archiviazione degli elementi della casella di riepilogo.

Parametri

wParam

Numero di elementi da aggiungere.

lParam

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

Valore restituito

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

Se il messaggio non riesce, il valore restituito viene CB_ERRSPACE.

Il messaggio alloca memoria e restituisce i valori di esito positivo e di errore descritti in precedenza.

Commenti

Il messaggio CB_INITSTORAGE consente di velocizzare l'inizializzazione delle caselle combinate con un numero elevato di elementi (oltre 100). Riserva la quantità di memoria specificata in modo che i successivi CB_ADDSTRING, CB_INSERTSTRING e CB_DIR messaggi 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, l'allocazione normale 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

CB_ADDSTRING

CB_DIR

CB_INSERTSTRING