Share via


CB_INITSTORAGE Nachricht

Eine Anwendung sendet die CB_INITSTORAGE Nachricht, bevor Sie dem Listenfeldteil eines Kombinationsfelds eine große Anzahl von Elementen hinzufügen. Diese Nachricht weist Speicher zum Speichern von Listenfeldelementen zu.

Parameter

wParam

Die Anzahl der elemente, die hinzugefügt werden sollen.

lParam

Die Menge des Speichers, der für Elementzeichenfolgen in Bytes zugewiesen werden soll.

Rückgabewert

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert die Gesamtzahl der Elemente, für die der Arbeitsspeicher vorab zugewiesen wurde, das heißt die Gesamtzahl der Elemente, die von allen erfolgreichen CB_INITSTORAGE Nachrichten hinzugefügt wurden.

Wenn die Nachricht fehlschlägt, ist der Rückgabewert CB_ERRSPACE.

Die Nachricht weist Arbeitsspeicher zu und gibt die oben beschriebenen Erfolgs- und Fehlerwerte zurück.

Bemerkungen

Die CB_INITSTORAGE Nachricht hilft, die Initialisierung von Kombinationsfeldern zu beschleunigen, die eine große Anzahl von Elementen (über 100) aufweisen. Es behält sich die angegebene Speichermenge vor, sodass nachfolgende CB_ADDSTRING, CB_INSERTSTRING und CB_DIR Nachrichten die kürzeste Zeit dauern. Sie können Schätzungen für die Parameter wParam und lParam verwenden. Wenn Sie überschätzen, wird der zusätzliche Speicher zugewiesen, wenn Sie die normale Zuweisung für Elemente verwenden, die den angeforderten Betrag überschreiten.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Header
Winuser.h (enthalten Windows.h)

Weitere Informationen

Referenz

CB_ADDSTRING

CB_DIR

CB_INSERTSTRING