List_Get_Next

include vmm.inc

mov esi, List ; list handle

mov eax, Node ; address of node

VMMcall List_Get_Next

jz empty_list ; zero flag set if not other nodes in list

mov [Node], eax ; address of next node


The List_Get_Next service returns the next node in a list. It is used to search a list for a specific element. When the service reaches the end of the list, it returns zero and sets the zero flag.

This service is typically used in conjunction with the List_Get_First service to scan an entire list.

Parameters

List

Specifies the handle identifying a list. The handle must have been previously created using the List_Create service.

Node

Specifies the address of a node in the list. The address must have been previously retrieved using the List_Get_First or List_Get_Next service.

Return Value

If the zero flag is clear, the EAX register contains the address of the next node in the list. If there are no other nodes in the list, the zero flag is set and EAX is zero.

Uses

EAX, Flags

See Also

List_Create, List_Get_First