LB_INITSTORAGE 메시지

목록 상자 항목을 저장하기 위한 메모리를 할당합니다. 이 메시지는 애플리케이션이 목록 상자에 많은 수의 항목을 추가하기 전에 사용됩니다.

매개 변수

wParam

추가할 항목 수입니다.

Windows 95/Windows 98/Windows Millennium Edition(Windows Me): wParam 매개 변수는 16비트 값으로 제한됩니다. 즉, 목록 상자는 32,767개 이상의 항목을 포함할 수 없습니다. 항목 수는 제한되어 있지만 목록 상자에 있는 항목의 총 바이트 크기는 사용 가능한 메모리에 의해서만 제한됩니다.

lParam

항목 문자열에 할당할 메모리 양(바이트)입니다.

반환 값

메시지가 성공하면 반환 값은 메모리가 사전 할당된 총 항목 수입니다. 즉 모든 성공적인 LB_INITSTORAGE 메시지가 추가한 총 항목 수입니다.

메시지가 실패하면 반환 값은 LB_ERRSPACE입니다.

Microsoft Windows NT 4.0: 이 메시지는 지정된 양의 메모리를 할당하지 않습니다. 그러나 항상 wParam 매개 변수에 지정된 값을 반환합니다.

설명

LB_INITSTORAGE 메시지는 항목 수가 많은(100개 이상) 목록 상자의 초기화 속도를 높이는 데 도움이 됩니다. 후속 LB_ADDSTRING, LB_INSERTSTRING, LB_DIR 및 LB_ADDFILE 메시지가 가능한 가장 짧은 시간이 걸리도록 지정된 양의 메모리를 예약합니다. wParam 및 lParam 매개 변수에 대한 예상 비용을 사용할 수 있습니다. 과대 평가하는 경우 추가 메모리가 할당됩니다. 과소 평가하는 경우 요청된 금액을 초과하는 항목에 대해 일반 할당이 사용됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
헤더	Winuser.h(Windows.h 포함)

추가 정보

참조

LB_ADDFILE

LB_ADDSTRING

LB_DIR

LB_INSERTSTRING