Get_Next_Profile_String

include vmm.inc

mov edx, Profile ; points to the previous entry value

mov edi, Keyname ; points to the entry name

VMMcall Get_Next_Profile_String

jc no_next ; carry flag set if there is no next value

mov [Next], edx ; points to entry value of next profile string


The Get_Next_Profile_String service searches the SYSTEM.INI file for the first entry that follows the entry specified by the Profile parameter, and that has the given keyname. This service returns a pointer to this next entry, if it is found.

Virtual devices typically use this service if they have more than one entry having the same keyname. 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.

Parameters

Profile

Points to 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.

Return Value

If the carry flag is clear, the EDX register contains the address of the next string having the specified keyname. The carry flag is set if there are no more matching entries.

Uses

EDX, Flags

See Also

Get_Profile_String