1.2.7 AddIniString – Hinzufügen eines IniFileWertes
AddIniString( strFileName, strSection, strKey, strValue );
Argumente
strFileName
Dateiname und relative Path der .ini-Datei, die Sie in den Profilstring aufnehmen möchten.
Der Pfad setzt sich zusammen aus TARGETDIR\relative Path\Dateiname.
Wird kein Pfad angegeben, geht Windows davon aus, dass sich die Datei im Windows-Verzeichnis befindet.
 
strSection
Des Name des .ini-Dateiabschnitts, in den der Profilstring aufgenommen werden soll.
Verwenden Sie keine eckigen Klammern für den Abschnittsnamen ( [ ] ). Wenn dieser Abschnitt nicht vorhanden ist, wird er erzeugt.
 
strKey
Der Name des Schlüssels, der in den Abschnitt aufgenommen werden soll.
Die Zeile strKey = strValue wird auch dann am Anfang des Abschnitts eingefügt, wenn bereits ein Eintrag für strKey vorhanden ist.
 
strValue
Der Wert, den Sie nach strKey einfügen möchten.
Rückgabewerte
n$Rc == 0
Schreiben erfolgreich
n$Rc <> 0
Fehler
Beschreibung
Die Funktion AddIniString führt eine unbedingte Aufnahme eines Profilstrings in eine .ini-Datei durch.
AddIniString kann nur für nicht eindeutige Schlüssel verwendet werden, z. B. die Schlüssel im Abschnitt [386Enh] der Systeminitialisierungsdatei
(device = ...).
AddIniString fügt die Zeile KEY=VALUE am Anfang des genannten .ini-Dateiabschnitts ein.
Sie führt keine Ersetzung oder Aktualisierung eines vorhandenen Schlüssels durch.
Um einen eindeutigen Schlüssel hinzuzufügen oder den Wert eines vorhandenen, eindeutigen Schlüssels in einer .ini-Datei zu aktualisieren, verwenden Sie WriteIniString.