Get_Profile_String

include vmm.inc

mov     edx, OFFSET32 Default   ; optional default string
mov     esi, OFFSET32 Profile   ; section name
mov     edi, OFFSET32 Keyname   ; entry name
VMMCall Get_Profile_String

jc      not_found               ; carry set if entry not found
mov     [Value], edx            ; address of profile string
 

Searches the SYSTEM.INI file for a specified entry, and returns a pointer to a null-terminated string representing the entry value. This service is only available during initialization. Uses EDX, Flags.

• Returns with the carry flag clear if the entry is found, set otherwise. If the carry flag is clear, the EDX register contains the address of the null-terminated string representing the entry value.

Default

Address of a null-terminated string to be returned if the entry is not found, or has no current value.

Profile

Address of a null-terminated string identifying the section in the SYSTEM.INI file to search. Can be zero, in which case the service searches the [386Enh] section.

Keyname

Address of a null-terminated string specifying keyname to search for.

A virtual device must not modify the string pointed to by the EDX register. If modification is required, copy the string and modify the copy.

See Also

Get_Next_Profile_String