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
VMMcall List_Get_First
 
jz      empty_list      ; zero flag set if list is empty
mov     [Node], eax     ; address of first node
 
The List_Get_First service returns a pointer to the first node in a list. If
the list is empty, it return 0 and the zero flag is set.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
List       Specifies the handle identifying a list. The handle must have
           been previously created using the List_Create service.
 
Return Value
 
If the zero flag is clear, the EAX register contains the address of the
first node in the list. If the list is empty, the zero flag is set and EAX
is zero.
 
Uses
 
EAX, Flags
 
See Also
 
List_Attach, List_Create, List_Get_Next
 
 
                                      ♦