ListGetNextItem

InstallShield 2024 » InstallScript Language Reference

The ListGetNextItem function retrieves the item after the current element in a number list. The retrieved item becomes the current element in the list.

Note:The ListGetNextItem function works only with number lists.

Syntax

ListGetNextItem ( listID, nvItem );

Parameters

ListGetNextItem Parameters
Parameter	Description
listID	Specifies the number list from which to retrieve the next element.
nvItem	Returns the item that follows the current element in the number list. That item becomes the current element in the list.

Return Values

ListGetNextItem Return Values
Return Value	Description
0	Indicates that the function successfully retrieved the element after the current element in a number list.
-1	Indicates that an error prevented the function from retrieving the specified element in a number list.
END_OF_LIST (1)	Indicates that the current item is the last element in the list.
ISERR_LIST_NOSUCHLIST (-501)	Indicates that a list with the specified ID does not exist. Valid list IDs are return values from the ListCreate function.