Delen via


LB_INITSTORAGE bericht

Hiermee wordt geheugen toegewezen voor het opslaan van keuzelijstitems. Dit bericht kan worden gebruikt voordat een toepassing een groot aantal items toevoegt aan een keuzelijst.

Parameterwaarden

wParam

Het aantal items waarvoor ruimte moet worden gereserveerd.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : de parameter wParam is beperkt tot 16-bits waarden. Dit betekent dat keuzelijsten niet meer dan 32.767 items mogen bevatten. Hoewel het aantal items beperkt is, wordt de totale grootte in bytes van de items in een keuzelijst alleen beperkt door het beschikbare geheugen.

lParam-

De hoeveelheid extra geheugen in bytes die moet worden toegewezen voor itemtekenreeksen.

Retourwaarde

Als het bericht is geslaagd, is de retourwaarde het totale aantal items dat in de keuzelijst kan worden opgeslagen voordat een herlocatie van het geheugen nodig is.

Als het bericht mislukt, wordt de retourwaarde LB_ERRSPACE.

Microsoft Windows NT 4.0: dit bericht wijst de opgegeven hoeveelheid geheugen niet toe; Deze retourneert echter altijd de waarde die is opgegeven in de parameter wParam .

Opmerkingen

Het LB_INITSTORAGE bericht helpt de initialisatie van keuzelijsten met een groot aantal items (meer dan 100) te versnellen. Het behoudt de opgegeven hoeveelheid geheugen zodat volgende LB_ADDSTRING, LB_INSERTSTRING, LB_DIR en LB_ADDFILE berichten efficiënter zijn. U kunt schattingen gebruiken voor de parameters wParam en lParam . Als u overschat, blijft het extra geheugen toegewezen; als u onderschat, wijst de keuzelijst indien nodig extra geheugen toe.

Het geheugen dat nodig is om een tekenreeks op te slaan, bevat de null-afsluiter. Als u dus van plan bent om 100 tekenreeksen toe te voegen, elk met een lengte van 10 tekens, geeft u een wParam van 100 en een lParam van 100 × (10 + 1) × grootte van (TCHAR).

Requirements

Requirement Waarde
Minimaal ondersteunde client
Windows Vista [alleen desktop-apps]
Minimaal ondersteunde server
Windows Server 2003 [alleen desktop-apps]
Header
Winuser.h (inclusief Windows.h)

Zie ook

Verwijzing

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING