WritePrivateProfileString
von ActiveVB-Team
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 LongWeitere 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 | |
---|---|
lpApplicationName | Zeiger 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. |
lpKeyName | Zeiger 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. |
lpString | Zeiger 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. |
lpFileName | Zeiger 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 | |
---|---|
1 | Die Funktion wurde erfolgreich ausgeführt. |
0 | Es lag ein Fehler vor. |
Tabelle 2
Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT
Verwandte API-Funktionen
GetPrivateProfileString, WriteProfileString
Zugehörige Tipps
- INI-Dateien Werte und Felder, erstellen und lesen [Tipp 0108]
- Einen IRC-Clienten per DDE fernsteuern [Tipp 0508]
Zugehörige Microsoft Knowledge Base Artikel