Freigeben über


GetUserDefaultGeoName-Funktion (winnls.h)

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
);

Parameters

[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

The size of the buffer that the geoName parameter specifies. 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.

Return value

The number of characters the function would copy to the output buffer if the value of the geoNameCount parameter is zero. Otherwise, the number of characters that the function copied to the buffer that the geoName parameter specifies.

Null gibt an, dass die Funktion fehlgeschlagen ist. To get extended error information, call GetLastError, which can return one of the following error codes:

Return code Description
ERROR_INVALID_PARAMETER Ein Parameterwert war ungültig.
ERROR_BADDB Die Funktion konnte keine Informationen aus der Registrierung lesen.
ERROR_INSUFFICIENT_BUFFER The buffer that the geoName parameter specifies is too small for the string.

Remarks

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).

Requirements

Requirement Value
mindestens unterstützte Client- Windows 10, Version 1709 [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2016 [nur Desktop-Apps]
Target Platform Windows
Header winnls.h (enthalten Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

See also