GetNLSVersion-Funktion (winnls.h)

Artikel
08/27/2023

Ruft Informationen zur aktuellen Version einer angegebenen NLS-Funktion für ein durch den Bezeichner angegebenes Gebietsschema ab.

Hinweis Aus Interoperabilitätsgründen sollte die Anwendung die GetNLSVersionEx-Funktion getNLSVersion vorziehen, da Microsoft zur Verwendung von Gebietsschemanamen anstelle von Gebietsschemabezeichnern für neue Gebietsschemas migriert. Diese Empfehlung gilt insbesondere für benutzerdefinierte Gebietsschemas, für die GetNLSVersionEx genügend Informationen abruft, um festzustellen, ob sich das Sortierverhalten geändert hat. Jede Anwendung, die nur unter Windows Vista und höher ausgeführt wird, sollte GetNLSVersionEx verwenden oder zumindest die NLSVERSIONINFOEX-Struktur übergeben, wenn GetNLSVersionVersion aufgerufen wird, um zusätzliche Sortierversionsdaten zu erhalten.

Syntax

BOOL GetNLSVersion(
  [in]      NLS_FUNCTION     Function,
  [in]      LCID             Locale,
  [in, out] LPNLSVERSIONINFO lpVersionInformation
);

Parameter

[in] Function

Die abzufragende NLS-Funktion. Dieser Wert muss COMPARE_STRING werden. Siehe SYSNLS_FUNCTION-Enumeration .

[in] Locale

Gebietsschemabezeichner , der das Gebietsschema angibt. Sie können das MAKELCID-Makro verwenden, um einen Bezeichner zu erstellen oder einen der folgenden vordefinierten Werte zu verwenden.

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

[in, out] lpVersionInformation

Zeiger auf eine NLSVERSIONINFO-Struktur . Die Anwendung muss das dwNLSVersionInfoSize-Element in sizeof(NLSVERSIONINFO)initialisieren.

Hinweis Unter Windows Vista und höher kann die Funktion alternativ Versionsinformationen in einer NLSVERSIONINFOEX-Struktur bereitstellen.

Rückgabewert

Gibt TRUE nur zurück, wenn die Anwendung gültige Werte in lpVersionInformation angegeben hat, oder andernfalls FALSE . Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError aufrufen, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

ERROR_INSUFFICIENT_BUFFER. Eine angegebene Puffergröße war nicht groß genug, oder sie wurde fälschlicherweise auf NULL festgelegt.
ERROR_INVALID_FLAGS. Die für Flags angegebenen Werte waren ungültig.
ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.

Hinweise

Mit dieser Funktion kann eine Anwendung wie Active Directory ermitteln, ob sich eine NLS-Änderung auf den Gebietsschemabezeichner auswirkt, der für eine bestimmte Indextabelle verwendet wird. Andernfalls muss die Tabelle nicht erneut indiziert werden. Weitere Informationen finden Sie unter Behandeln der Sortierung in Ihren Anwendungen.

Anforderungen


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