Funzione SetUserGeoID (winnls.h)

Articolo
08/27/2023

[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