Freigeben über

GetUserDefaultGeoName-Funktion (winnls.h)

  • Artikel

Ruft den standardmäßigen geografischen Standort des Benutzers als international Organization for Standardization (ISO) 3166-1 aus zwei Buchstaben bestehender Code ab, falls verfügbar. Andernfalls wird ein numerischer Code der Vereinten Nationen (UN) M, Zahl 49 (M.49) angegeben.

Syntax

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

Parameter

[out] geoName

Zeiger auf einen Puffer, in dem diese Funktion den 3166-1-Zwei-Buchstaben-Code der Internationalen Organisation für Normung (ISO) 3166-1 oder einen Numerischen Code der Vereinten Nationen (UN) M, Zahl 49 (M.49) schreiben soll.

[in] geoNameCount

Die Größe des Puffers, den der geoName-Parameter angibt. Wenn dieser Wert null ist, gibt die Funktion nur die Anzahl der Zeichen zurück, die die Funktion in den Ausgabepuffer kopieren würde, aber nicht den Namen des Standardstandorts des Benutzers in den Puffer schreibt.

Rückgabewert

Die Anzahl der Zeichen, die die Funktion in den Ausgabepuffer kopieren würde, wenn der Wert des geoNameCount Parameter null ist. Andernfalls gibt 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 zum Abrufen erweiterter Fehlerinformationen GetLastErrorauf, der eine der folgenden Fehlercodes zurückgeben kann:

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.

Bemerkungen

Wenn der ISO 3166-1-Code für den standardmäßigen geografischen Standort des Benutzers "XX" ist (was angibt, dass kein Code zugewiesen wurde), aber der Standort hat einen UN M.49-Code zugewiesen, dann wird der M.49-Code als Dezimalzeichenfolge zurückgegeben.

Wenn der ISO 3166-1-Code für den standardmäßigen geografischen Standort des Benutzers "XX" ist (was angibt, dass kein Code zugewiesen wurde), der Standort jedoch einen UN M.49-Code zugewiesen hat, wird der M.49-Code als Dezimalzeichenfolge zurückgegeben.

Informationen zu iso 3166-1-Codes mit zwei Buchstaben finden Sie unter ISO 3166-Ländercodes.

Informationen zu numerischen UN-M.49-Codes finden Sie unter Standardland- oder Ortsvorwahlen für die statistische Verwendung (M49).

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 10, Version 1709 [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2016 [nur Desktop-Apps]
Zielplattform- Fenster
Header- winnls.h (enthalten Windows.h)
Library Kernel32.lib
DLL- Kernel32.dll

Siehe auch