Get_Next_Profile_String

mov ax, 0001h ; Get_Next_Profile_String

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

; real-mode initialization procedure


The Get_Next_Profile_String service retrieves the address of a null-terminated string representing the next value for a specified setting in the SYSTEM.INI file. This service is used by virtual devices that have multiple entries with the same setting name.

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

Parameters

AX

Must be 0001h.

DS:DI

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

ES:DX

Contains an address that was previously retrieved using the Get_Profile_String or Get_Next_Profile_String service.

Return Value

If the carry flag is clear, the ES:DX register pair contains the address of a null-terminated string representing the next value of the requested setting. Otherwise, the ES:DX contents are undefined, and no more matching entries are found.

Uses

EAX, EDX, ES, Flags