ListGetNextItem

InstallShield 2014 ยป 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.

See Also