IsValidLocaleName-Funktion (winnls.h)

Bestimmt, ob der angegebene Gebietsschemaname für ein Gebietsschema gültig ist, das auf dem Betriebssystem installiert oder unterstützt wird.

Hinweis Eine Anwendung, die nur unter Windows Vista und höher ausgeführt wird, sollte diese Funktion vor IsValidLocale aufrufen, um die Gültigkeit eines zusätzlichen Gebietsschemas zu bestimmen.

 

Syntax

BOOL IsValidLocaleName(
  [in] LPCWSTR lpLocaleName
);

Parameter

[in] lpLocaleName

Zeiger auf den zu überprüfenden Gebietsschemanamen.

Rückgabewert

Gibt einen Nonzero-Wert zurück, wenn der Gebietsschemaname gültig ist, oder gibt 0 für einen ungültigen Namen zurück.

Hinweise

Unter Windows Vista und höher sollten alle unterstützten Gebietsschemas auf allen Betriebssystemen installiert werden.

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

Ab Windows 8: Wenn Ihre App Sprachtags aus dem Windows.Globalization-Namespace an diese Funktion übergibt, müssen die Tags zuerst konvertiert werden , indem ResolveLocaleName aufgerufen wird.

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter NLS: Beispiel für namenbasierte APIs.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winnls.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetLocaleInfoEx

IsValidLocale

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen