GetUserDefaultLocaleName-Funktion (winnls.h)
Ruft den Standardnamen des Gebietsschemas des Benutzers ab.
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.
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 |