LM_SETITEMHANDLE

This message sets the handle of the specified list box item.

Syntax

param1
SHORT sItemIndex;   /* Item index. */

param2
ULONG ulItemHandle; /* Item handle. */

Parameters

sItemIndex (SHORT) - input

Item index.

ulItemHandle (ULONG) - input

Item handle.

Returns

rc (BOOL) - return

Success indicator.

TRUE: Successful completion.

FALSE: Error occurred.

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 the handle of the item whose index is specified by sItemIndex to the value specified by ulItemHandle.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it, other than to set rc to the default value of FALSE.