Funzione GetGeoInfoEx (winnls.h)
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 |
---|---|
|
Le dimensioni del buffer fornite non sono sufficienti o non sono state impostate correttamente su NULL. |
|
Valore di parametro non valido. |
|
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 |
Vedere anche
Supporto per la lingua nazionale