Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
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 return 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.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
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
 
 
                                      ♦