Freigeben über


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
ERROR_INVALID_PARAMETER
Ein Parameterwert war ungültig.
ERROR_BADDB
Die Funktion konnte keine Informationen aus der Registrierung lesen.
ERROR_INSUFFICIENT_BUFFER
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

GetUserGeoID

Unterstützung für landessprachliche Sprachen

Unterstützungsfunktionen für nationalsprachliche Sprachen

SetUserGeoName