WritePrivateProfileSection
von ActiveVB-Team
Deklaration
Declare Function WritePrivateProfileSection Lib "kernel32" _ Alias "WritePrivateProfileSectionA" ( _ ByVal lpAppName As String, _ ByVal lpString As String, _ ByVal lpFileName As String) As LongWeitere 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 | |
---|---|
lpAppName | Zeiger auf einen nullterminierten String, der den Abschnittsnamen aufnimmt. Wenn der abschnittsname in einer INI-Datei nicht existiert, wird er erzeugt. |
lpString | Zeiger 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. |
lpFileName | Zeiger 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 | |
---|---|
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
GetPrivateProfileSection, RegCreateKeyEx, RegSetValueEx, WriteProfileSection
Zugehörige Tipps