Fungsi SetUserGeoName (winnls.h)

Artikel
03/04/2024

Mengatur lokasi geografis untuk pengguna saat ini ke kode dua huruf International Organization for Standardization (ISO) 3166-1 yang ditentukan atau kode Numerik United Nations (UN) Series M, Nomor 49 (M.49).

Sintaks

BOOL SetUserGeoName(
  [in] PWSTR geoName
);

Parameter

[in] geoName

Kode ISO 3166-1 atau NUMERIC UN M.49 dua huruf untuk lokasi geografis yang akan diatur untuk pengguna saat ini. Untuk mendapatkan kode yang tersedia di sistem operasi, panggil EnumSystemGeoNames.

Mengembalikan nilai

Mengembalikan TRUE jika berhasil atau FALSE sebaliknya.

Jika fungsi ini tidak berhasil, panggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

Menampilkan kode	Deskripsi
ERROR_ACCESS_DISABLED_BY_POLICY	Kebijakan grup komputer atau pengguna telah melarang operasi ini.
ERROR_INTERNAL_ERROR	Terjadi kesalahan tak terduga dalam fungsi.
ERROR_INVALID_PARAMETER	Nilai parameter tidak valid.

Keterangan

Fungsi ini menulis ke registri lokasi geografis untuk pengguna tertentu alih-alih aplikasi tertentu. Tindakan ini memengaruhi perilaku aplikasi lain yang dijalankan pengguna. Sebagai aturan, panggil fungsi ini hanya ketika pengguna telah secara eksplisit meminta perubahan, tetapi tidak karena alasan khusus aplikasi murni.

Untuk informasi tentang kode ISO 3166-1 dua huruf, lihat Kode Negara - ISO 3166. Untuk informasi tentang kode NUMERIC UN M.49, lihat Kode negara atau area standar untuk penggunaan statistik (M49).

SetUserGeoName ditujukan untuk digunakan oleh aplikasi yang dirancang untuk mengubah pengaturan pengguna, seperti aplikasi Pengaturan Windows. Aplikasi lain tidak boleh memanggil fungsi ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll