LM_QUERYITEMHANDLE

This message returns the handle of the indexed item of the list box control.

Syntax

param1
SHORT sItemIndex; /* Item index. */

param2
ULONG ulReserved; /* Reserved value, should be 0. */

Parameters

sItemIndex (SHORT) - input

Item index.

ulReserved (ULONG) - input

Reserved value, should be 0.

Returns

ulItem (ULONG) - return

Item handle.

0: The indexed item does not exist.

Other: Item handle.

Remarks

The meaning of the item handle is defined by the application. It may, for example, be a pointer to an application defined data structure.

Item handles are initialized to NULLHANDLE when an item is created. The list box control window procedure responds to this message by setting ulItem to the handle of the item whose index is specified by sItemIndex.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it, other than to set ulItem to the default value of NULLHANDLE. The item handle is initialized to NULLHANDLE.