GetUserDefaultGeoName-Funktion (winnls.h)
Ruft den zweistelligen Code der Internationalen Organisation für Normung (ISO) 3166-1 oder den numerischen Code der United Nations (UN) Serie M, Nummer 49 (M.49) für den geografischen Standardstandort des Benutzers ab.
Syntax
int GetUserDefaultGeoName(
[out] LPWSTR geoName,
[in] int geoNameCount
);
Parameter
[out] geoName
Zeiger auf einen Puffer, in den diese Funktion den null-endigen, zwei buchstabenlosen ISO 3166-1- oder numerischen UN M.49-Code für den standardmäßigen geografischen Standort des Benutzers schreiben soll.
[in] geoNameCount
Die Größe des Puffers, den der geoName-Parameter angibt. Wenn dieser Wert 0 ist, gibt die Funktion nur die Anzahl der Zeichen zurück, die die Funktion in den Ausgabepuffer kopieren würde, schreibt jedoch nicht den Namen des standardmäßigen geografischen Standorts des Benutzers in den Puffer.
Rückgabewert
Die Anzahl der Zeichen, die die Funktion in den Ausgabepuffer kopieren würde, wenn der Wert des geoNameCount-Parameters null ist. Andernfalls die Anzahl der Zeichen, die die Funktion in den Puffer kopiert hat, den der geoName-Parameter angibt.
Null gibt an, dass die Funktion fehlgeschlagen ist. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten, die einen der folgenden Fehlercodes zurückgeben können:
| Rückgabecode | Beschreibung |
|---|---|
|
Ein Parameterwert war ungültig. |
|
Die Funktion konnte keine Informationen aus der Registrierung lesen. |
|
Der puffer, den der geoName-Parameter angibt, ist für die Zeichenfolge zu klein. |
Hinweise
Informationen zu den zweistelligen ISO 3166-1-Codes finden Sie unter Ländercodes – ISO 3166. Informationen zu numerischen UN M.49-Codes finden Sie unter Standard-Länder- oder Gebietsvorwahlen zur statistischen Verwendung (M49).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 10, Version 1709 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2016 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | winnls.h (windows.h einschließen) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |
Siehe auch
Unterstützung für landessprachliche Sprachen