GetGeoInfoEx-Funktion (winnls.h)

  • Artikel

Ruft Informationen zu einem geografischen Standort ab, den Sie mithilfe eines Codes der Internationalen Organisation für Normung (ISO) 3166-1 aus zwei Buchstaben oder mit numerischem Code der Vereinten Nationen (UN) Serie M, Nummer 49 (M.49) angeben.

Syntax

int GetGeoInfoEx(
  [in]            PWSTR   location,
  [in]            GEOTYPE geoType,
  [out, optional] PWSTR   geoData,
  [in]            int     geoDataCount
);

Parameter

[in] location

Der zwei buchstabenige ISO 3166-1- oder numerische UN M.49-Code für den geografischen Standort, für den Informationen abgerufen werden sollen. Rufen Sie EnumSystemGeoNames auf, um die codes abzurufen, die auf dem Betriebssystem verfügbar sind.

[in] geoType

Der Typ der Informationen, die Sie abrufen möchten. Mögliche Werte werden durch die SYSGEOTYPE-Enumeration definiert. Die folgenden Werte der SYSGEOTYPE-Enumeration sollten nicht mit GetGeoInfoEx verwendet werden:

  • GEO_ID

    Dieser Wert wird nur aus Gründen der Abwärtskompatibilität bereitgestellt. Verwenden Sie diesen Wert nicht in neuen Anwendungen, sondern stattdessen GEO_NAME .

  • GEO_LCID

    Dieser Wert wird für die GetGeoInfoEx-Funktion nicht unterstützt.

  • GEO_NATION

    Dieser Wert wird für die GetGeoInfoEx-Funktion nicht unterstützt.

  • GEO_RFC1766

    Dieser Wert wird für die GetGeoInfoEx-Funktion nicht unterstützt.

[out, optional] geoData

Ein Zeiger auf den Puffer, in den GetGeoInfoEx die angeforderten Informationen schreiben soll.

[in] geoDataCount

Die Größe des Puffers, auf den der GeoData-Parameter verweist, in Zeichen. Legen Sie diesen Parameter auf 0 fest, um anzugeben, dass die Funktion nur die Größe des Puffers zurückgeben soll, der zum Speichern der angeforderten Informationen erforderlich ist, ohne die angeforderten Informationen in den Puffer zu schreiben.

Rückgabewert

Die Anzahl der Bytes der Geografischen Standortinformationen, die die Funktion für den Ausgabepuffer geschrieben hat. Wenn geoDataCount 0 ist, gibt die Funktion die Größe des Puffers zurück, der zum Halten der Informationen erforderlich ist, ohne die Informationen in den Puffer zu schreiben.

0 gibt an, dass die Funktion nicht erfolgreich war. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf, wodurch einer der folgenden Fehlercodes zurückgegeben werden kann:

Rückgabecode Beschreibung
ERROR_INSUFFICIENT_BUFFER
 Die angegebene Puffergröße war nicht groß genug, oder sie wurde fälschlicherweise auf NULL festgelegt.
ERROR_INVALID_PARAMETER
 Ein Parameterwert war ungültig.
ERROR_INVALID_FLAGS
 Die für Flags angegebenen Werte waren ungültig.

Hinweise

Informationen zu iso 3166-1-Codes mit zwei Buchstaben finden Sie unter Ländercodes – ISO 3166. Informationen zu numerischen UN M.49-Codes finden Sie unter Standardland- oder Gebietscodes für statistische 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
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

EnumSystemGeoNames

GetGeoInfo

Unterstützung für nationale Sprachen

Nationale Sprachunterstützungsfunktionen

SYSGEOTYPE