Funzione GetUserDefaultGeoName (winnls.h)

Recupera il codice ISO (International Organization for Standardization) 3166-1 o numeric United Nations (UN) Series M, Numero 49 (M.49) per la posizione geografica predefinita dell'utente.

Sintassi

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

Parametri

[out] geoName

Puntatore a un buffer in cui questa funzione deve scrivere il codice ISO 3166-1 con terminazione Null o un codice UN M.49 numerico per la posizione geografica predefinita dell'utente.

[in] geoNameCount

Dimensione del buffer specificata dal parametro geoName . Se questo valore è zero, la funzione restituisce solo il numero di caratteri che la funzione copia nel buffer di output, ma non scrive il nome della posizione geografica predefinita dell'utente nel buffer.

Valore restituito

Il numero di caratteri che la funzione copierà nel buffer di output, se il valore del parametro geoNameCount è zero. In caso contrario, il numero di caratteri copiati dalla funzione nel buffer specificato dal parametro geoName .

Zero 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_INVALID_PARAMETER
Valore di parametro non valido.
ERROR_BADDB
La funzione non è riuscita a leggere le informazioni dal Registro di sistema.
ERROR_INSUFFICIENT_BUFFER
Il buffer specificato dal parametro geoName è troppo piccolo per la stringa.

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 (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

GetUserGeoID

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale

SetUserGeoName