GetProfileSectionA-Funktion (winbase.h)

Artikel
03/03/2024

Ruft alle Schlüssel und Werte für den angegebenen Abschnitt der Win.ini-Datei ab.

Hinweis Diese Funktion wird nur zur Kompatibilität mit 16-Bit-Windows-basierten Anwendungen bereitgestellt. Anwendungen sollten Initialisierungsinformationen in der Registrierung speichern.

Syntax

DWORD GetProfileSectionA(
  [in]  LPCSTR lpAppName,
  [out] LPSTR  lpReturnedString,
  [in]  DWORD  nSize
);

Parameter

[in] lpAppName

Der Name des Abschnitts in der Win.ini-Datei.

[out] lpReturnedString

Ein Zeiger auf einen Puffer, der die Schlüssel und Werte empfängt, die dem benannten Abschnitt zugeordnet sind. Der Puffer wird mit einer oder mehreren NULL-Zeichenfolgen gefüllt. auf die letzte Zeichenfolge folgt ein zweites NULL-Zeichen.

[in] nSize

Die Größe des Puffers, auf den der parameter lpReturnedString in Zeichen verweist.

Die maximale Profilabschnittsgröße beträgt 32.767 Zeichen.

Rückgabewert

Der Rückgabewert gibt die Anzahl der Zeichen an, die in den angegebenen Puffer kopiert wurden, ohne das beendende NULL-Zeichen. Wenn der Puffer nicht groß genug ist, um alle Schlüssel und Werte zu enthalten, die dem benannten Abschnitt zugeordnet sind, entspricht der Rückgabewert der von nSize minus 2 angegebenen Größe.

Hinweise

Das Format der zurückgegebenen Schlüssel und Werte ist mindestens eine NULL-Zeichenfolge, gefolgt von einem letzten NULL-Zeichen. Jede Zeichenfolge hat die folgende Form: Schlüsselzeichenfolge=

Bei der GetProfileSection-Funktion wird die Groß-/Kleinschreibung nicht beachtet. die Zeichenfolgen können eine Kombination aus Groß- und Kleinbuchstaben sein.

Dieser Vorgang ist atomar; Es sind keine Aktualisierungen der Win.ini-Datei zulässig, während die Schlüssel und Werte für den Abschnitt in den Puffer kopiert werden.

Windows Server 2003 und Windows XP/2000: Aufrufe von Profilfunktionen können der Registrierung und nicht den Initialisierungsdateien zugeordnet werden. Diese Zuordnung tritt auf, wenn die Initialisierungsdatei und der Abschnitt in der Registrierung unter dem folgenden Schlüssel angegeben werden: HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\IniFileMapping.

Wenn der Vorgang zugeordnet wurde, ruft die GetProfileSection-Funktion Informationen aus der Registrierung ab, nicht aus der Initialisierungsdatei. die Änderung des Speicherorts hat keine Auswirkungen auf das Verhalten der Funktion.

Die Profilfunktionen verwenden die folgenden Schritte, um Initialisierungsinformationen zu suchen:

Suchen Sie in der Registrierung nach dem Namen der Initialisierungsdatei unter dem Schlüssel IniFileMapping .
Suchen Sie nach dem von lpAppName angegebenen Abschnittsnamen. Dies ist ein benannter Wert unter dem Schlüssel, der den Namen der Initialisierungsdatei enthält, oder ein Unterschlüssel mit diesem Namen, oder der Name ist weder als Wert noch als Unterschlüssel vorhanden.
Wenn der von lpAppName angegebene Abschnittsname ein benannter Wert ist, gibt dieser Wert an, wo sie in der Registrierung die Schlüssel für den Abschnitt finden.
Wenn der von lpAppName angegebene Abschnittsname ein Unterschlüssel ist, geben benannte Werte unter diesem Unterschlüssel an, wo sie in der Registrierung die Schlüssel für den Abschnitt finden. Wenn der gesuchte Schlüssel nicht als benannter Wert vorhanden ist, gibt es einen unbenannten Wert (als <Kein Name>), der den Standardspeicherort in der Registrierung angibt, in der Sie den Schlüssel finden.
Wenn der von lpAppName angegebene Abschnittsname nicht als benannter Wert oder als Unterschlüssel vorhanden ist, gibt es einen unbenannten Wert (als No Name>)< an, 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 den Inhalt.

Beim Betrachten von Werten in der Registrierung, die andere Registrierungsspeicherorte angeben, gibt es mehrere Präfixe, die das Verhalten der .ini Dateizuordnung ändern:

! – Dieses Zeichen erzwingt, dass alle Schreibvorgänge sowohl zur Registrierung als auch zur .ini Datei auf dem Datenträger gelangen.
# : 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 nicht in der Registrierung 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\SOFTWARE, und der Text nach dem Präfix ist relativ zu diesem Schlüssel.

Hinweis

Der winbase.h-Header definiert GetProfileSection 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 nicht codierungsneutralem Code 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

GetPrivateProfileSection

WriteProfileSection

Share via