RtlIsValidLocaleName-Funktion

Bestimmt, ob ein durch den Namen angegebenes Gebietsschema unter dem Betriebssystem installiert oder unterstützt wird.

Hinweis

Diese Funktion ist nur für die Verwendung in Windows Vista verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. Anwendungen sollten IsValidLocaleName verwenden.

 

Syntax

BOOL RtlIsValidLocaleName(
  _In_ LPCWSTR LocaleName,
  _In_ ULONG   Flags
);

Parameter

LocaleName [in]

Zu überprüfende Gebietsschemaname . Dieser Parameter kann den Namen eines benutzerdefinierten Gebietsschemas angeben.

Flaggen [in]

Flags, die angeben, ob neutrale Gebietsschemas als gültig gelten. Derzeit ist das einzige definierte Flag LOCALE_ALLOW_NEUTRAL. Der Standardwert ist, dass sie nicht sind.

Rückgabewert

Gibt bei erfolgreicher Ausführung einen wert ungleichen Wert zurück, andernfalls 0.

Bemerkungen

Diese Funktion ähnelt IsValidLocaleName. Der einzige Unterschied besteht darin LOCALE_ALLOW_NEUTRAL, dass RtlIsValidLocaleNametrue für einen Namen zurückgibt, der einem neutralen Gebietsschema entspricht (z. B. "en"), während IsValidLocaleNametrue nur für ein bestimmtes Gebietsschema (z. B. "en-US") zurückgibt. Neutrale Gebietsschemas werden als Teil der Strategie zum Laden von Ressourcen in Windows Vista und höher verwendet. Nur eine kleine Klasse hochspezialisierter Anwendungen verwendet RtlIsValidLocaleName und legt LOCALE_ALLOW_NEUTRAL fest, da neutrale Gebietsschemas nur sehr begrenzt verwendet werden. Keine der unter Aufrufen der Funktionen "Gebietsschemaname" beschriebenen Funktionen akzeptiert neutrale Gebietsschemas als Eingaben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Ntrtl.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen

IsValidLocaleName