GetUserDefaultLocaleName-Funktion (winnls.h)
Ruft den Standardschemanamen 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, in Zeichen, des Puffers, der von lpLocaleName angegeben ist. Die maximale Länge eines Gebietsschemanamens, einschließlich eines terminierenden Nullzeichens, ist LOCALE_NAME_MAX_LENGTH. Dies ist die empfohlene Größe, die in diesem Parameter bereitgestellt werden soll.
Rückgabewert
Gibt die Größe des Puffers zurück, der den Gebietsschemanamen enthält, einschließlich des terminierenden Nullzeichens, falls erfolgreich.
Die Funktion gibt 0 zurück, wenn sie nicht erfolgreich ist. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError aufrufen, die einen der folgenden Fehlercodes zurückgeben kann:
- ERROR_INSUFFICIENT_BUFFER. Eine angegebene Puffergröße war nicht groß genug, oder es wurde falsch auf NULL festgelegt.
Hinweise
Diese Funktion kann Daten aus benutzerdefinierten Gebietsschemas abrufen. Daten sind nicht garantiert, dass sie von Computer zu Computer oder zwischen Ausführung einer Anwendung identisch sind. Wenn Ihre Anwendung Daten beibehalten oder übertragen muss, finden Sie unter Verwenden von persistenten Gebietsschemadaten.
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 (enthalten Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |