Funzione SetUserGeoID (winnls.h)
[SetUserGeoID è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece SetUserGeoName.
]
Imposta l'identificatore di posizione geografica per l'utente. Questo identificatore deve avere uno dei valori descritti in Tabella delle posizioni geografiche.
Sintassi
BOOL SetUserGeoID(
[in] GEOID GeoId
);
Parametri
[in] GeoId
Identificatore per la posizione geografica dell'utente.
Valore restituito
Restituisce TRUE se ha esito positivo o FALSE in caso contrario.
Windows XP, Windows Server 2003: questa funzione non fornisce informazioni di errore estese. Pertanto, non è appropriato per un'applicazione chiamare GetLastError dopo questa funzione. Se l'applicazione chiama GetLastError, può restituire un valore impostato da una funzione denominata in precedenza.
Se questa funzione non riesce, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:
- 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. Uno dei valori dei parametri 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, l'applicazione deve chiamare questa funzione solo quando l'utente ha richiesto in modo esplicito modifiche, ma non per motivi puramente specifici dell'applicazione.
SetUserGeoID è destinato all'uso da parte delle applicazioni progettate per modificare le impostazioni utente, ad esempio l'app Impostazioni di Windows. Altre applicazioni non devono chiamare questa funzione.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winnls.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |
Vedere anche
Supporto per la lingua nazionale