Funzione GetGeoInfoEx (winnls.h)

Articolo
08/27/2023

Recupera informazioni su una posizione geografica specificata utilizzando un codice ISO (International Organization for Standardization) 3166-1 o numeric United Nations (UN) Series M, Numero 49 (M.49).

Sintassi

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

Parametri

[in] location

Codice ISO 3166-1 o UN M.49 numerico a due lettere per la posizione geografica per cui ottenere informazioni. Per ottenere i codici disponibili nel sistema operativo, chiamare EnumSystemGeoNames.

[in] geoType

Tipo di informazioni da recuperare. I valori possibili sono definiti dall'enumerazione SYSGEOTYPE . I valori seguenti dell'enumerazione SYSGEOTYPE non devono essere usati con GetGeoInfoEx:

GEO_ID
Questo valore è disponibile per compatibilità con le versioni precedenti. Non usare questo valore nelle nuove applicazioni, ma usare invece GEO_NAME .
GEO_LCID
Questo valore non è supportato per la funzione GetGeoInfoEx .
GEO_NATION
Questo valore non è supportato per la funzione GetGeoInfoEx .
GEO_RFC1766
Questo valore non è supportato per la funzione GetGeoInfoEx .

[out, optional] geoData

Puntatore al buffer in cui GetGeoInfoEx deve scrivere le informazioni richieste.

[in] geoDataCount

Dimensione del buffer a cui punta il parametro GeoData , espresso in caratteri. Impostare questo parametro su 0 per specificare che la funzione deve restituire solo le dimensioni del buffer necessarie per archiviare le informazioni richieste senza scrivere le informazioni richieste nel buffer.

Valore restituito

Numero di byte di informazioni sulla posizione geografica scritte dalla funzione nel buffer di output. Se geoDataCount è 0, la funzione restituisce le dimensioni del buffer necessarie per contenere le informazioni senza scrivere le informazioni nel buffer.

0 indica che la funzione non è riuscita. Per ottenere informazioni sull'errore estese, chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

Codice restituito	Descrizione
ERROR_INSUFFICIENT_BUFFER	Le dimensioni del buffer fornite non sono sufficienti o non sono state impostate correttamente su NULL.
ERROR_INVALID_PARAMETER	Valore di parametro non valido.
ERROR_INVALID_FLAGS	I valori specificati per i flag non sono validi.

Commenti

Per informazioni sui codici ISO 3166-1 a due lettere, vedere Codici paese - ISO 3166. Per informazioni sui codici numerici UN M.49, vedere Codici paese o area standard per uso statistico (M49).

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1709 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winnls.h
Libreria	Kernel32.lib
DLL	Kernel32.dll