IsValidLocale-Funktion (winnls.h)

Artikel
08/27/2023

[IsValidLocale ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen IsValidLocaleName , um die Gültigkeit eines zusätzlichen Gebietsschemas zu bestimmen.]

Bestimmt, ob das angegebene Gebietsschema auf dem Betriebssystem installiert oder unterstützt wird. Weitere Informationen finden Sie unter Gebietsschemas und Sprachen.

Syntax

BOOL IsValidLocale(
  [in] LCID  Locale,
  [in] DWORD dwFlags
);

Parameter

[in] Locale

Gebietsschemabezeichner des zu überprüfenden Gebietsschemas. Sie können das MAKELCID-Makro verwenden, um einen Gebietsschemabezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.

LOCALE_CUSTOM_DEFAULTWindows Server 2003, Windows XP und Windows 2000: Dieser Gebietsschemabezeichner wird nicht unterstützt.
LOCALE_CUSTOM_UI_DEFAULTWindows Server 2003, Windows XP und Windows 2000: Dieser Gebietsschemabezeichner wird nicht unterstützt.
LOCALE_CUSTOM_UNSPECIFIEDWindows Server 2003, Windows XP und Windows 2000: Dieser Gebietsschemabezeichner wird nicht unterstützt.
LOCALE_INVARIANT
LOCALE_SYSTEM_DEFAULT
LOCALE_USER_DEFAULT

[in] dwFlags

Flag, das den Gültigkeitstest angibt, der auf den Gebietsschemabezeichner angewendet werden soll. Dieser Parameter kann einen der folgenden Werte aufweisen.

Wert	Bedeutung
LCID_INSTALLED	Ermitteln Sie, ob der Gebietsschemabezeichner sowohl unterstützt als auch installiert wird.
LCID_SUPPORTED	Ermitteln Sie, ob der Gebietsschemabezeichner unterstützt wird.
0x39	Nicht verwenden. Verwenden Sie stattdessen LCID_INSTALLED. Windows Server 2008, Windows Vista, Windows Server 2003, Windows XP und Windows 2000: Das Festlegen von dwFlags auf 0x39 ist ein Sonderfall, der sich für einige Gebietsschemas in einigen Versionen von Windows wie LCID_INSTALLED verhalten kann.

Rückgabewert

Gibt einen Wert ungleich null zurück, wenn der Gebietsschemabezeichner den angegebenen Gültigkeitstest besteht. Die Funktion gibt 0 zurück, wenn sie nicht erfolgreich ist.

Hinweise

Wenn das flag LCID_INSTALLED angegeben ist und diese Funktion einen Wert ungleich null zurückgibt, wird der Gebietsschemabezeichner sowohl unterstützt als auch auf dem Betriebssystem installiert. Wenn ein Bezeichner installiert ist, bedeutet dies, dass die vollständige Sprachunterstützung für das angegebene Gebietsschema verfügbar ist. Die vollständige Unterstützung umfasst Codepageübersetzungstabellen, Tastaturlayouts, Schriftarten sowie Sortier- und Gebietsschemadaten.

Wenn LCID_SUPPORTED angegeben ist und diese Funktion 0 zurückgibt, wird der Gebietsschemabezeichner im Release unterstützt, aber nicht unbedingt auf dem Betriebssystem installiert.

Diese Funktion kann Daten aus benutzerdefinierten Gebietsschemas verarbeiten. Es ist nicht garantiert, dass die Daten von Computer zu Computer oder zwischen Ausführungen einer Anwendung identisch sind. Wenn Ihre Anwendung Daten beibehalten oder übertragen muss, finden Sie weitere Informationen unter Verwenden persistenter Gebietsschemadaten.

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

Siehe auch

GetLocaleInfo

IsValidLocaleName

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen

Freigeben über