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 |
|