Bagikan melalui


Fungsi SetUserGeoID (winnls.h)

[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

Lihat juga

GetUserGeoID

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

SetUserGeoName

Tabel Lokasi Geografis