Get_Next_Profile_String

include vmm.inc

mov     edx, Profile    ; points to the previous entry value
mov     edi, Keyname    ; points to the keyname for the entry
VMMCall Get_Next_Profile_String

jc      no_next         ; carry flag set if no more entries
mov     [Next], edx     ; address of next profile string
 

Searches the SYSTEM.INI file for the next entry with a given keyname following the specified entry. Virtual devices typically use this service if they have more than one entry with the same keyname. This service is available only during initialization. Uses EDX, Flags.

• Returns with the carry flag clear if an entry is found, set otherwise. If the carry flag is clear, the EDX register contains the address of the next string with the specified keyname.

Profile

Address of a null-terminated string specifying the value of the previous entry. The string must have been previously returned using the Get_Profile_String or Get_Next_Profile_String service.

Keyname

Points to a null-terminated string identifying the keyname for the entry.

A virtual device retrieves the first string using the Get_Profile_String service, then uses Get_Next_Profile_String to retrieve all subsequent entries. In all cases, the virtual device must not modify the returned string.

See Also

Get_Profile_String