GetCPInfoExA-Funktion (winnls.h)

Artikel
11/20/2024

Ruft Informationen zu allen gültigen installierten oder verfügbaren Codeseiten ab.

Syntax

BOOL GetCPInfoExA(
  [in]  UINT        CodePage,
  [in]  DWORD       dwFlags,
  [out] LPCPINFOEXA lpCPInfoEx
);

Parameter

[in] CodePage

Bezeichner für die Codeseite, für die Informationen abgerufen werden sollen. Die Anwendung kann den Codeseitenbezeichner für jede installierte oder verfügbare Codeseite oder einen der folgenden vordefinierten Werte angeben. Eine Liste der Bezeichner für ANSI und andere Codeseiten finden Sie unter Codepage-IDs.

Wert	Bedeutung
CP_ACP	Verwenden Sie die Standardmäßige Windows ANSI-Codeseite des Systems.
CP_MACCP	Verwenden Sie die Standardmäßige Macintosh-Codeseite des Systems.
CP_OEMCP	Verwenden Sie die standardmäßige OEM-Standardcodeseite des Systems.
CP_THREAD_ACP	Verwenden Sie die ANSI-Codeseite des aktuellen Threads.

[in] dwFlags

Reserviert; muss 0 sein.

[out] lpCPInfoEx

Zeiger auf eine CPINFOEX- Struktur, die Informationen zur Codeseite empfängt.

Rückgabewert

Gibt einen Wert ungleich Null zurück, wenn dies erfolgreich war, oder 0 andernfalls. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastErroraufrufen, wodurch eine der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_INVALID_PARAMETER. Ungültige Parameterwerte.

Bemerkungen

Die in der CPINFOEX Struktur abgerufenen Informationen sind nicht immer für alle Codeseiten nützlich. Um Puffergrößen zu ermitteln, sollte die Anwendung z. B. MultiByteToWideChar- oder WideCharToMultiByte- aufrufen, um eine genaue Puffergröße anzufordern. Wenn CPINFOEX- Einstellungen angeben, dass ein Leadbyte vorhanden ist, behandelt die Konvertierungsfunktion lead bytes nicht unbedingt anders, z. B. bei fehlenden oder illegalen Trail-Byte.

Anmerkung

Der winnls.h-Header definiert GetCPInfoEx 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 [Desktop-Apps \| UWP-Apps]
mindestens unterstützte Server-	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Zielplattform-	Fenster
Header-	winnls.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll

Siehe auch

Freigeben über