Freigeben über


GetCPInfoExA-Funktion (winnls.h)

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

Syntax

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

Parameter

[in] CodePage

Bezeichner für die Codepage, für die Informationen abgerufen werden sollen. Die Anwendung kann den Codepagebezeichner für alle installierten oder verfügbaren Codepages oder einen der folgenden vordefinierten Werte angeben. Eine Liste der Bezeichner für ANSI und andere Codepages finden Sie unter Codepage-Bezeichner .

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

[in] dwFlags

Reserviert; muss 0 sein.

[out] lpCPInfoEx

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

Rückgabewert

Gibt bei erfolgreicher Ausführung einen Wert ungleich 0 zurück, andernfalls 0. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

  • ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Hinweise

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

Hinweis

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
Unterstützte Mindestversion (Client) Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winnls.h (windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

CPINFOEX

GetACP

GetCPInfo

GetOEMCP

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen