Fungsi SetUserGeoID (winnls.h)

Artikel
03/08/2023

[SetUserGeoID tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini dapat diubah atau tidak tersedia dalam versi berikutnya. Sebagai gantinya, gunakan SetUserGeoName.

]

Mengatur pengidentifikasi lokasi geografis untuk pengguna. Pengidentifikasi ini harus memiliki salah satu nilai yang dijelaskan dalam Tabel Lokasi Geografis.

Sintaks

BOOL SetUserGeoID(
  [in] GEOID GeoId
);

Parameter

[in] GeoId

Pengidentifikasi untuk lokasi geografis pengguna.

Nilai kembali

Mengembalikan TRUE jika berhasil atau FALSE sebaliknya.

Windows XP, Windows Server 2003: Fungsi ini tidak menyediakan informasi kesalahan yang diperluas. Dengan demikian tidak tepat bagi aplikasi untuk memanggil GetLastError setelah fungsi ini. Jika aplikasi memanggil GetLastError, aplikasi dapat mengembalikan nilai yang ditetapkan oleh beberapa fungsi yang disebut sebelumnya.

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

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. Salah satu 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 oleh pengguna. Sebagai aturan, aplikasi harus memanggil fungsi ini hanya ketika pengguna telah secara eksplisit meminta perubahan, tetapi tidak karena alasan khusus aplikasi murni.

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

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll