Get_Profile_String

mov ax, 0000h ; Get_Profile_String

call cs:[ecx] ; points to service entry point passed to

; real-mode initialization procedure


The Get_Profile_String service searches the SYSTEM.INI file for the specified entry, and returns a pointer to a string.

This service is available only with Windows version 3.1 or later.

Parameters

AX

Must be 0000h.

DS:SI

Points to a null-terminated string specifying the name of the section to search. If the SI register is zero, the service searches the [386Enh] section of the SYSTEM.INI file.

DS:DI

Points to a null-terminated string specifying the name of the setting to search for.

ES:DX

Points to null-terminated string specifying the default value if the requested setting is not found.

Return Value

If the carry flag is clear, the ES:DX register pair contains the address of a null-terminated string representing the value of the requested setting. Otherwise, the register pair points to the default string.

Comments

The real-mode initialization procedure must not modify the returned string. The address returned points to the initialization file data area and is read only.

Uses

EAX, EDX, ES, Flags