Die Community zu .NET und Classic VB.
Menü

WritePrivateProfileSection

 von 

Deklaration  

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

WritePrivateProfileSection schreibt Schlüsselzuweisungen in einen Abschnitt einer INI-Datei. Diese Schlüsselzuweisungen ersetzen den Abschnittsinhalt. Werte für die Schlüssel, die in einem Abschnitt exisistieren, nicht aber in der Liste der Puffereinträge, werden einfach gelöscht.

Parameter
lpAppNameZeiger auf einen nullterminierten String, der den Abschnittsnamen aufnimmt. Wenn der abschnittsname in einer INI-Datei nicht existiert, wird er erzeugt.
lpStringZeiger auf einen Puffer, der die Schlüssel und Werte des Abschnitts enthält, der gespeichtert werden soll. Dabei handelt es sich um eine Liste nullterminierter Strings in Form von Schlüsselzuweisungen: Schlüssel = Wert. Dem letzten String folgt ein zusätzliches Terminierungszeichen. Sofern hier ein leerer String ("") übergeben wird, wird die Sektion aus der INI-Datei entfernt.
lpFileNameZeiger auf einen nullterminierten String, der den Namen der INI-Datei enthält. Wenn dieser Parameter keinen vollständigen Pfadnamen enthält, sucht Windows die Datei 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
GetPrivateProfileSection, RegCreateKeyEx, RegSetValueEx, WriteProfileSection

Zugehörige Tipps