Funzione SetUserGeoName (winnls.h)

  • Articolo

Imposta la posizione geografica per l'utente corrente sul codice ISO (International Organization for Standardization) 3166-1 specificato o numeric United Nations (UN) Series M, Numero 49 (M.49).

Sintassi

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

Parametri

[in] geoName

Codice ISO 3166-1 o UN M.49 numerico a due lettere per la posizione geografica da impostare per l'utente corrente. Per ottenere i codici disponibili nel sistema operativo, chiamare EnumSystemGeoNames.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario.

Se questa funzione non riesce, chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

Codice restituito Descrizione
ERROR_ACCESS_DISABLED_BY_POLICY
 I criteri di gruppo del computer o dell'utente non hanno consentito questa operazione.
ERROR_INTERNAL_ERROR
 Si è verificato un errore imprevisto nella funzione .
ERROR_INVALID_PARAMETER
 Valore di parametro non valido.

Commenti

Questa funzione scrive nel Registro di sistema la posizione geografica per un determinato utente anziché un'applicazione specifica. Questa azione influisce sul comportamento di altre applicazioni eseguite dall'utente. Come regola, chiamare questa funzione solo quando l'utente ha richiesto in modo esplicito le modifiche, ma non per motivi puramente specifici dell'applicazione.

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).

SetUserGeoName è destinato all'uso da parte di applicazioni progettate per modificare le impostazioni utente, ad esempio l'app Impostazioni di Windows. Altre applicazioni non devono chiamare questa funzione.

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

EnumSystemGeoNames

GetUserDefaultGeoName

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale

SetUserGeoID