LB _ INITSTORAGE-Nachricht

Belegt Arbeitsspeicher zum Speichern von Listenfeldelementen. Diese Meldung wird verwendet, bevor eine Anwendung einem Listenfeld eine große Anzahl von Elementen hinzufügt.

Parameter

wParam

Die Anzahl der hinzuzufügende Elemente.

Windows 95/Windows 98/Windows Edition (Windows Me): Der wParam-Parameter ist auf 16-Bit-Werte beschränkt. Das bedeutet, dass Listenfelder nicht mehr als 32.767 Elemente enthalten dürfen. Obwohl die Anzahl der Elemente eingeschränkt ist, ist die Gesamtgröße der Elemente in einem Listenfeld in Byte nur durch den verfügbaren Arbeitsspeicher beschränkt.

lParam

Die Menge an Arbeitsspeicher in Bytes, die für Elementzeichenfolgen zugeordnet werden soll.

Rückgabewert

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert die Gesamtanzahl der Elemente, für die Speicher vorab zugeordnet wurde, d. h. die Gesamtzahl der Elemente, die von allen erfolgreichen LB _ INITSTORAGE-Nachrichten hinzugefügt wurden.

Wenn die Nachricht fehlschlägt, lautet der Rückgabewert LB _ ERRSPACE.

Microsoft Windows NT 4.0: Diese Meldung weist nicht die angegebene Arbeitsspeichermenge zu. Sie gibt jedoch immer den im wParam-Parameter angegebenen Wert zurück.

Hinweise

Die LB _ INITSTORAGE-Nachricht beschleunigt die Initialisierung von Listenfeldern mit einer großen Anzahl von Elementen (mehr als 100). Sie reserviert die angegebene Menge an Arbeitsspeicher, sodass nachfolgende LB _ ADDSTRING-, LB _ INSERTSTRING-, LB _ DIR-und LB _ ADDFILE-Nachrichten so kurz wie möglich dauern. Sie können Schätzungen für die Parameter wParam und lParam verwenden. Wenn Sie überbewerten, wird der zusätzliche Arbeitsspeicher belegt. Wenn Sie dies abschätzen, wird die normale Zuordnung für Elemente verwendet, die den angeforderten Betrag überschreiten.

Anforderungen

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

Siehe auch

Verweis

LB _ ADDFILE

LB _ ADDSTRING

LB _ DIR

LB _ INSERTSTRING