LB_INITSTORAGE Nachricht
Reserviert 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ügenden Elemente.
Windows 95/Windows 98/Windows Millennium Edition (Windows Me): Der wParam-Parameter ist auf 16-Bit-Werte beschränkt. Dies bedeutet, dass Listenfelder nicht mehr als 32.767 Elemente enthalten dürfen. Obwohl die Anzahl der Elemente eingeschränkt ist, wird die Gesamtgröße der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.
-
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 Gesamtzahl der Elemente, für die Arbeitsspeicher vorab zugewiesen wurde, d. h. die Gesamtanzahl der Elemente, die von allen erfolgreichen LB_INITSTORAGE Nachrichten hinzugefügt wurden.
Wenn die Nachricht fehlschlägt, wird der Rückgabewert LB_ERRSPACE.
Microsoft Windows NT 4.0: Diese Meldung weist nicht die angegebene Arbeitsspeichermenge zu. Es gibt jedoch immer den im wParam-Parameter angegebenen Wert zurück.
Bemerkungen
Die LB_INITSTORAGE Meldung hilft, die Initialisierung von Listenfeldern zu beschleunigen, die eine große Anzahl von Elementen (mehr als 100) enthalten. Es reserviert die angegebene Arbeitsspeichermenge, sodass nachfolgende LB_ADDSTRING, LB_INSERTSTRING, LB_DIR und LB_ADDFILE Nachrichten so schnell wie möglich dauern. Sie können Schätzungen für die Parameter wParam und lParam verwenden. Wenn Sie überschätzen, wird der zusätzliche Arbeitsspeicher zugewiesen. wenn Sie unterschätzen, wird die normale Zuordnung für Elemente verwendet, die den angeforderten Betrag überschreiten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|
Weitere Informationen
-
Referenz