WriteProfileString

WriteProfileString schreibt einen String in den angegebenen Abschnitt einer Initialisierungsdatei bzw. in die Registrierdatenbank.

bool = WriteProfileString(ssSection, ssKey, ssString)

bool = WriteProfileString(ssSection, ssKey, ssString, ssFileName)

Returnwert

bool ist TRUE (1), wenn die Funktion erfolgreich war und FALSE (0), wenn die Funktion nicht erfolgreich war.

Parameter

ssSection

ssSection enthält den Abschnittsnamen. Wenn der Abschnitt nicht existiert, wird er erzeugt. Der Name kann eine beliebige Kombination aus Groß- und Kleinbuchstaben sein.

ssKey

ssKey ist der Schlüsselname. Wenn der Name nicht existiert, wird er erzeugt. Wenn ssKey ein leerer String ist (String der Länge 0) werden alle Einträge des Abschnitts gelöscht.

ssString

ssString ist ein skalarer String der in die Initialisierungsdatei geschrieben wird. Wenn ssString ein leerer String ist (String der Länge 0), wird der Schlüssel ssKey gelöscht.

ssFileName

In ssFileName kann der komplette Name (Dateiname mit Pfad) einer Initialisierungsdatei angegeben werden. Falls die Datei nicht existiert, wird sie erzeugt. Wenn dieser Parameter nicht angegeben wird, wird die Windows-Registrierdatenbank verwendet und zwar unter dem Schlüsselnamen HKEY_CURRENT_USER\Software\RSB\UniPlot5.

Beispiel

Der folgende Aufruf erzeugt eine INI-Datei (test.ini)

WriteProfileString("Section", "Key", "Test", "d:/test.ini")

mit dem Inhalt

[Section]
Key=Test

Kommentar

Falls INI-Dateien geschrieben werden, wird in UNICODE-INI-Dateien UNICODE geschrieben, sonst ANSI. UniPlot erzeugt per Default ANSI-Dateien. INI-Dateien können auch nachträglich, z. B. mit notepad.exe, in UNICODE-Dateien umgewandelt werden.

History

Version	Beschreibung
5.10.1	Falls eine INI-Datei geschrieben wird, werden Zeichen mit einem Code kleiner 0x20 (blank) als Escape-Sequenzen geschrieben. Vor den String wird in diesem Fall die Zeichenkette “esc:” geschrieben.

Siehe auch

Überblick Dateien, GetProfileString, WriteProfileInt

_id-1988435