Die Community zu .NET und Classic VB.
Menü

WritePrivateProfileString

 von 

Deklaration  

Declare Function WritePrivateProfileString Lib "kernel32" _
                 Alias "WritePrivateProfileStringA" ( _
                 ByVal lpApplicationName As String, _
                 ByVal lpKeyName As Any, _
                 ByVal lpString As Any, _
                 ByVal lpFileName As String) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel WritePrivateProfileString des API-Wikis.

WritePrivateProfileString speichert einen Stringwert, der einem Schlüssel eines bestimmten Abschnitts einer INI-Datei zugeordnet ist.

Parameter
lpApplicationNameZeiger auf einen nullterminierten String, der den Abschnittsnamen enthält. Wenn lpApplicationName, lpKeyName und lpString Null sind, schreibt das System den Inhalt der INI-Datei auf die Platte.
lpKeyNameZeiger auf einen nullterminierten String, der den Namen des Schlüssels enthält, dessen Name geschrieben werden soll. Wenn der Schlüssel in diesem Abschnitt nicht exisitiert, wird er erzeugt. sind sowohl lpKeyName als auch lpString gleich Null, werden alle Schlüsselnamen des angegebenen Abschnitts gelöscht, auch der Abschnittsheader selbst.
lpStringZeiger auf einen nullterminierten String, der den Wert enthält, welcher für den angegebenen Schlüssel lpKeyName im Abschnitt lpApplicationName der INI-Datei geschrieben werden soll. Ist dieser Parameter gleich Null, wird der Schlüssel aus dem Abschnitt entfernt.
lpFileNameZeiger auf einen nullterminierten String, der den Namen der INI-Datei darstellt. Wenn lpFileName keinen vollständigen Pfadnamen darstellt, erzeugt Windows sie im Windows-Verzeichnis.

Tabelle 1


Rückgabewerte
1Die Funktion wurde erfolgreich ausgeführt.
0Es lag ein Fehler vor.

Tabelle 2


Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
GetPrivateProfileString, WriteProfileString

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel