LB_INITSTORAGE Nachricht

Ordnet Speicher zum Speichern von Listenfeldelementen zu. Diese Meldung kann verwendet werden, bevor eine Anwendung einem Listenfeld eine große Anzahl von Elementen hinzufügt.

Die Parameter

wParam

Die Anzahl der Elemente, für die Speicherplatz reserviert werden soll.

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, ist die Gesamtgröße in Byte der Elemente in einem Listenfeld nur durch den verfügbaren Arbeitsspeicher begrenzt.

lParam

Die Menge an zusätzlichem Arbeitsspeicher in Bytes, die für Elementzeichenfolgen zugewiesen werden sollen.

Rückgabewert

Wenn die Nachricht erfolgreich ist, ist der Rückgabewert die Gesamtanzahl der Elemente, die das Listenfeld speichern kann, bevor eine Speicher-Neuzuweisung erforderlich ist.

Wenn die Nachricht fehlschlägt, wird 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.

Bemerkungen

Die LB_INITSTORAGE Nachricht hilft beim Beschleunigen der Initialisierung von Listenfeldern mit einer großen Anzahl von Elementen (mehr als 100). Es behält sich die angegebene Speichermenge vor, sodass nachfolgende LB_ADDSTRING, LB_INSERTSTRING, LB_DIR und LB_ADDFILE Nachrichten effizienter sind. Sie können Schätzungen für die Parameter wParam und lParam verwenden. Wenn Sie den Wert überschätzen, bleibt der zusätzliche Arbeitsspeicher zugeordnet; Wenn Sie dies unterschätzen, weist das Listenfeld bei Bedarf zusätzlichen Arbeitsspeicher zu.

Der zum Speichern einer Zeichenfolge erforderliche Arbeitsspeicher enthält den Null-Terminator. Wenn Sie also beabsichtigen, 100 Zeichenfolgen mit jeweils einer Länge von 10 Zeichen hinzuzufügen, würden Sie eine wParam von 100 und eine lParam von 100 × (10 + 1) × Sizeof(TCHAR) übergeben.

Anforderungen

Siehe auch

Referenz

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING