DownlevelLocaleNameToLCID-Funktion

Konvertiert einen Gebietsschemanamen in einen Gebietsschemabezeichner, mit dem Informationen aus dem Betriebssystem abgerufen werden können.

Hinweis

Diese Funktion wird nur von Anwendungen verwendet, die unter älteren Betriebssystemen als Windows Vista ausgeführt werden. Ihre Verwendung erfordert das Downloadpaket. Anwendungen, die nur unter Windows Vista und höher ausgeführt werden, sollten LocaleNameToLCID aufrufen, um einen Gebietsschemabezeichner abzurufen.

 

Syntax

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

Parameter

lpName [in]

Zeiger auf eine nullterminierte Zeichenfolge, die einen Gebietsschemanamen darstellt.

dwFlags [in]

Flags, die den Typ des Namens angeben. Der Standardwert lautet DOWNLEVEL_LOCALE_NAME.

Rückgabewert

Gibt den Gebietsschemabezeichner zurück, der dem Gebietsschemanamen entspricht, wenn die Funktion erfolgreich ausgeführt wird.

Diese Funktion gibt 0 zurück, wenn sie nicht erfolgreich ausgeführt wird. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastError aufrufen, sodass einer der folgenden Fehlercodes zurückgegeben werden kann:

  • ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
  • ERROR_INVALID_PARAMETER. Ein Parameterwert war ungültig.

Hinweise

Hinweis

Diese Funktion unterstützt keine neutralen Gebietsschemas. Die entsprechende LocaleNameToLCID-Funktion unterstützt benutzerdefinierte Gebietsschemas, jedoch nur für Windows Vista und höher.

 

Die erforderliche Headerdatei und die DLL-Datei sind Teil des Downloads „Microsoft NLS Downlevel Data Mapping APIs“, der im Microsoft Download Center nicht mehr verfügbar ist. Verwenden Sie ICU-Globalisierungs-APIs unter Windows 10, Update Mai 2019 und höheren Versionen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2003 [nur Desktop-Apps]
Verteilbar
Microsoft NLS Downlevel Data Mapping APIs unter Windows XP mit SP2 und höher oder Windows Vista
Header
Nlsdl.h
DLL
NlsMap.dll

Siehe auch

Unterstützung der Landessprache

Funktionen zur Unterstützung der Landessprache

Zuordnen von Gebietsschemadaten

LocaleNameToLCID