Condividi tramite

Funzione GetUserDefaultGeoName (winnls.h)

  • Articolo

Recupera la posizione geografica predefinita dell'utente come codice ISO (International Organization for Standardization) 3166-1, se disponibile. In caso contrario, un codice numerico delle Nazioni Unite (UN) Serie M, Numero 49 (M.49).

Sintassi

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

Parametri

[out] geoName

Puntatore a un buffer in cui questa funzione deve scrivere il codice numerico ISO (International Organization for Standardization) con terminazione Null (ISO) 3166-1 o un codice numerico serie M (UN) delle Nazioni Unite (UN), numero 49 (M.49).

[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 copiato dalla funzione 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 estese sull'errore, chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

Codice restituito Descrizione
ERROR_INVALID_PARAMETER Il valore di un 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.

Osservazioni

Se il codice ISO 3166-1 per la posizione geografica predefinita dell'utente è "XX" (a indicare che non è stato assegnato alcun codice), ma la posizione ha un codice UN M.49 assegnato, il codice M.49 viene restituito come stringa decimale.

Se il codice ISO 3166-1 per la posizione geografica predefinita dell'utente è 'XX' (che indica che non è stato assegnato alcun codice), ma la posizione ha un codice UN M.49 assegnato, il codice M.49 viene restituito come stringa decimale.

Per informazioni sui codici ISO 3166-1 a due lettere, vedere codici paese ISO 3166.

Per informazioni sui codici UN M.49 numerici, vedere paese standard o codici di area per l'uso statistico (M49).

Fabbisogno

Requisito Valore
client minimo supportato Windows 10, versione 1709 [solo app desktop]
server minimo supportato Windows Server 2016 [solo app desktop]
piattaforma di destinazione Finestre
intestazione winnls.h (include Windows.h)
libreria Kernel32.lib
dll Kernel32.dll

Vedere anche