GetGeoInfoEx-Funktion (winnls.h)
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 |
|---|---|
|
Die angegebene Puffergröße war nicht groß genug, oder sie wurde fälschlicherweise auf NULL festgelegt. |
|
Ein Parameterwert war ungültig. |
|
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
Unterstützung für nationale Sprachen