WriteProfileSectionA-Funktion (winbase.h)
Ersetzt den Inhalt des angegebenen Abschnitts in der Win.ini Datei durch angegebene Schlüssel und Werte. Wenn Win.ini Unicode-Zeichen verwendet, schreibt die Funktion Unicode-Zeichen in die Datei. Andernfalls schreibt die Funktion ANSI-Zeichen.
Syntax
BOOL WriteProfileSectionA(
[in] LPCSTR lpAppName,
[in] LPCSTR lpString
);
Parameter
[in] lpAppName
Der Name des Abschnitts. Dieser Abschnittsname ist in der Regel der Name der aufrufenden Anwendung.
[in] lpString
Die neuen Schlüsselnamen und zugeordneten Werte, die in den benannten Abschnitt geschrieben werden sollen. Diese Zeichenfolge ist auf 65.535 Bytes beschränkt.
Wenn die Datei vorhanden ist und mit Unicode-Zeichen erstellt wurde, schreibt die Funktion Unicode-Zeichen in die Datei. Andernfalls erstellt die Funktion eine Datei mit ANSI-Zeichen.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Schlüssel und Werte im lpString- Puffer bestehen aus einem oder mehreren NULL--terminated strings, gefolgt von einem endgültigen NULL- Zeichen. Jede Zeichenfolge hat die folgende Form: Schlüssel=Zeichenfolge.
Bei der WriteProfileSection--Funktion wird die Groß-/Kleinschreibung nicht beachtet. Die Zeichenfolgen können eine Kombination aus Groß- und Kleinbuchstaben sein.
WriteProfileSection die vorhandenen Schlüssel und Werte für den benannten Abschnitt löscht und die Schlüsselnamen und Werte in den Puffer einfügt, auf die durch lpString-verwiesen wird. Die Funktion versucht nicht, alte und neue Schlüsselnamen zu korrelieren; Wenn die neuen Namen in einer anderen Reihenfolge als die alten Namen angezeigt werden, werden alle Kommentare, die bereits vorhandenen Schlüsseln und Werten in der Initialisierungsdatei zugeordnet sind, wahrscheinlich falschen Schlüsseln und Werten zugeordnet.
Dieser Vorgang ist atomar; keine anderen Vorgänge, die aus der Initialisierungsdatei gelesen oder in die Initialisierungsdatei geschrieben werden, sind zulässig.
Das System behält eine zwischengespeicherte Version der neuesten Registrierungsdateizuordnung bei, um die Leistung zu verbessern. Wenn alle Parameter NULL-sind, löscht die Funktion den Cache. Während das System die zwischengespeicherte Version der Datei bearbeitet, verwenden Prozesse, die die Datei selbst bearbeiten, die ursprüngliche Datei, bis der Cache gelöscht wurde.
Das System ordnet die meisten .ini Dateiverweise der Registrierung zu, wobei die unter dem folgenden Registrierungsschlüssel definierte Zuordnung verwendet wird:
HKEY_LOCAL_MACHINE SOFTWARE Microsoft Windows NT CurrentVersion IniFileMapping
Wenn der Vorgang zugeordnet wurde, schreibt die WriteProfileSection-Funktion Informationen in die Registrierung, nicht in die Initialisierungsdatei; die Änderung am Speicherort hat keine Auswirkungen auf das Verhalten der Funktion.
Die Profilfunktionen verwenden die folgenden Schritte, um Initialisierungsinformationen zu finden:
- Suchen Sie in der Registrierung nach dem Namen der Initialisierungsdatei unter dem schlüssel IniFileMapping.
- Suchen Sie nach dem durch lpAppNameangegebenen Abschnittsnamen. Dies ist ein benannter Wert unter dem Schlüssel, der den Namen der Initialisierungsdatei oder einen Unterschlüssel mit diesem Namen enthält, oder der Name ist nicht als Wert oder Unterschlüssel vorhanden.
- Wenn der durch lpAppName angegebene Abschnittsname ein benannter Wert ist, gibt dieser Wert an, wo in der Registrierung die Schlüssel für den Abschnitt gefunden werden.
- Wenn der durch lpAppName angegebene Abschnittsname ein Unterschlüssel ist, geben benannte Werte unter diesem Unterschlüssel an, wo in der Registrierung die Schlüssel für den Abschnitt gefunden werden. Wenn der gesuchte Schlüssel nicht als benannter Wert vorhanden ist, gibt es einen unbenannten Wert (wie <No Name>), der den Standardspeicherort in der Registrierung angibt, an dem Sie den Schlüssel finden.
- Wenn der durch lpAppName angegebene Abschnittsname nicht als benannter Wert oder als Unterschlüssel vorhanden ist, gibt es einen unbenannten Wert (wie <No Name>), der den Standardspeicherort in der Registrierung angibt, an dem Sie die Schlüssel für den Abschnitt finden.
- Wenn kein Unterschlüssel oder Eintrag für den Abschnittsnamen vorhanden ist, suchen Sie nach der tatsächlichen Initialisierungsdatei auf dem Datenträger, und lesen Sie deren Inhalt.
- ! - Dieses Zeichen zwingt alle Schreibvorgänge, sowohl zur Registrierung als auch zur .ini Datei auf dem Datenträger zu wechseln.
- # - Dieses Zeichen bewirkt, dass der Registrierungswert auf den Wert in der Windows 3.1-.ini-Datei festgelegt wird, wenn sich ein neuer Benutzer nach dem Setup zum ersten Mal anmeldet.
- @ - Dieses Zeichen verhindert, dass lesevorgänge zur .ini Datei auf dem Datenträger wechseln, wenn die angeforderten Daten in der Registrierung nicht gefunden werden.
- USR: - Dieses Präfix steht für HKEY_CURRENT_USER, und der Text nach dem Präfix ist relativ zu diesem Schlüssel.
- SYS: - Dieses Präfix steht für HKEY_LOCAL_MACHINE\SOFTWAREund der Text nach dem Präfix relativ zu diesem Schlüssel.
Anmerkung
Der winbase.h-Header definiert WriteProfileSection als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |