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 |