Fungsi GetUserDefaultGeoName (winnls.h)

Mengambil kode dua huruf International Organization for Standardization (ISO) 3166-1 atau kode numerik United Nations (UN) Series M, Number 49 (M.49) untuk lokasi geografis default pengguna.

Sintaks

int GetUserDefaultGeoName(
  [out] LPWSTR geoName,
  [in]  int    geoNameCount
);

Parameter

[out] geoName

Penunjuk ke buffer di mana fungsi ini harus menulis kode ISO 3166-1 dua huruf null-dihentikan atau numerik UN M.49 untuk lokasi geografis default pengguna.

[in] geoNameCount

Ukuran buffer yang ditentukan parameter geoName . Jika nilai ini nol, fungsi hanya mengembalikan jumlah karakter yang akan disalin fungsi ke buffer output, tetapi tidak menulis nama lokasi geografis default pengguna ke buffer.

Mengembalikan nilai

Jumlah karakter yang akan disalin fungsi ke buffer output, jika nilai parameter geoNameCount adalah nol. Jika tidak, jumlah karakter yang disalin fungsi ke buffer yang ditentukan parameter geoName .

Zero menunjukkan bahwa fungsi gagal. Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

Menampilkan kode	Deskripsi
ERROR_INVALID_PARAMETER	Nilai parameter tidak valid.
ERROR_BADDB	Fungsi tidak dapat membaca informasi dari registri.
ERROR_INSUFFICIENT_BUFFER	Buffer yang ditentukan parameter geoName terlalu kecil untuk string.

Keterangan

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

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

Lihat juga

GetUserGeoID

Dukungan Bahasa Nasional

Fungsi Dukungan Bahasa Nasional

SetUserGeoName