GetUserDefaultLocaleName-Funktion (winnls.h)

  • Artikel

Ruft den Standardnamen des Gebietsschemas des Benutzers ab.

Hinweis Die Anwendung sollte diese Funktion vor dem Befehl GetUserDefaultLCID aufrufen, wenn sie nur unter Windows Vista und höher ausgeführt werden soll.

 

Syntax

int GetUserDefaultLocaleName(
  [out] LPWSTR lpLocaleName,
  [in]  int    cchLocaleName
);

Parameter

[out] lpLocaleName

Zeiger auf einen Puffer, in dem diese Funktion den Gebietsschemanamen abruft.

[in] cchLocaleName

Größe des durch lpLocaleName angegebenen Puffers in Zeichen. Die maximal mögliche Länge eines Gebietsschemanamens, einschließlich eines abschließenden NULL-Zeichens, ist LOCALE_NAME_MAX_LENGTH. Dies ist die empfohlene Größe, die in diesem Parameter angegeben werden soll.

Rückgabewert

Gibt die Größe des Puffers zurück, der den Gebietsschemanamen enthält, einschließlich des abschließenden NULL-Zeichens, falls erfolgreich.

Hinweis Auf Einzelbenutzersystemen entspricht der Rückgabewert dem Rückgabewert, der von GetSystemDefaultLocaleName zurückgegeben wird.

 

Die Funktion gibt 0 zurück, wenn sie nicht erfolgreich ist. Um erweiterte Fehlerinformationen zu erhalten, 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.

Hinweise

Diese Funktion kann Daten aus benutzerdefinierten Gebietsschemas abrufen. 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 Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile winnls.h (windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetLocaleInfoEx

GetSystemDefaultLocaleName

GetUserDefaultLCID

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen