LVM_SETITEMINDEXSTATE message

Sets the state of a list-view item. Send this message explicitly or by using the ListView_SetItemIndexState macro.

Parameters

wParam [in]

A pointer to an LVITEMINDEX structure for the item. The calling process is responsible for allocating this structure and setting the members.

lParam [in]

A pointer to an LVITEM structure. The calling process is responsible for allocating memory for the structure. Set the state member to one or more (as a bitwise combination) of the List-View Item States flags. Set the stateMask member of the structure to indicate the valid bits of the state member. For more information, see the stateMask member of the LVITEM structure.

Return value

Returns one of the following values of type HRESULT.

Return code Description
E_FAIL
The state could not be set.
E_UNEXPECTED
The list-view control was not ready for the operation.
S_OK
The operation was successful.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Commctrl.h