ConvertDefaultLocale-Funktion (winnls.h)

Artikel
03/04/2024

Konvertiert einen Standardgebietsschemawert in einen tatsächlichen Gebietsschemabezeichner.

Hinweis Diese Funktion wird nur zum Konvertieren von Teilgebietsschemabezeichnern bereitgestellt. Ihre Anwendungen sollten Gebietsschemanamen anstelle von Bezeichnern verwenden. Die LCIDToLocaleName-Funktion kann verwendet werden, um einen Gebietsschemabezeichner in einen gültigen Gebietsschemanamen zu konvertieren. Ihre Anwendung kann auch GetUserDefaultLocaleName verwenden, um den aktuellen Benutzergebietsnamen abzurufen. GetSystemDefaultLocaleName zum Abrufen des aktuellen Systemgebietsschemanamens; und GetLocaleInfoEx mit LOCALE_SNAME zum Abrufen des Gebietsschemanamens für jedes Eingabegebietsschema, einschließlich der Standardkonstanten.

Syntax

LCID ConvertDefaultLocale(
  [in] LCID Locale
);

Parameter

[in] Locale

Der zu konvertierende Standard-Gebietsschemabezeichnerwert. Sie können das MAKELCID-Makro verwenden, um einen Gebietsschemabezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.

Windows Vista und höher: Die folgenden benutzerdefinierten Gebietsschemabezeichner werden ebenfalls unterstützt.

Rückgabewert

Gibt bei erfolgreicher Ausführung den entsprechenden Gebietsschemabezeichner zurück.

Diese Funktion gibt den Wert des Locale-Parameters zurück, wenn sie nicht erfolgreich ist. Die Funktion schlägt fehl, wenn der Locale-Wert nicht einer der oben aufgeführten Standardwerte ist.

Hinweise

Ein Aufruf von ConvertDefaultLocale , der LOCALE_SYSTEM_DEFAULT angibt, entspricht einem Aufruf von GetSystemDefaultLCID. Ein Aufruf von ConvertDefaultLocale , der LOCALE_USER_DEFAULT angibt, entspricht einem Aufruf von GetUserDefaultLCID.

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	winnls.h (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll