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     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 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.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
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
 
 
                                      ♦