Fungsi GetGeoInfoEx (winnls.h)

Artikel
03/13/2024

Mengambil informasi tentang lokasi geografis yang Anda tentukan dengan menggunakan kode Dua huruf International Organization for Standardization (ISO) 3166-1 atau kode Numeric United Nations (UN) Series M, Angka 49 (M.49).

Sintaks

int GetGeoInfoEx(
  [in]            PWSTR   location,
  [in]            GEOTYPE geoType,
  [out, optional] PWSTR   geoData,
  [in]            int     geoDataCount
);

Parameter

[in] location

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

[in] geoType

Jenis informasi yang ingin Anda ambil. Nilai yang mungkin ditentukan oleh enumerasi SYSGEOTYPE . Nilai enumerasi SYSGEOTYPE berikut tidak boleh digunakan dengan GetGeoInfoEx:

GEO_ID
Nilai ini disediakan untuk kompatibilitas mundur. Jangan gunakan nilai ini dalam aplikasi baru, tetapi gunakan GEO_NAME sebagai gantinya.
GEO_LCID
Nilai ini tidak didukung untuk fungsi GetGeoInfoEx .
GEO_NATION
Nilai ini tidak didukung untuk fungsi GetGeoInfoEx .
GEO_RFC1766
Nilai ini tidak didukung untuk fungsi GetGeoInfoEx .

[out, optional] geoData

Penunjuk ke buffer di mana GetGeoInfoEx harus menulis informasi yang diminta.

[in] geoDataCount

Ukuran buffer tempat parameter GeoData menunjuk, dalam karakter. Atur parameter ini ke 0 untuk menentukan bahwa fungsi hanya boleh mengembalikan ukuran buffer yang diperlukan untuk menyimpan informasi yang diminta tanpa menulis informasi yang diminta ke buffer.

Mengembalikan nilai

Jumlah byte informasi lokasi geografis yang ditulis fungsi buffer output. Jika geoDataCount adalah 0, fungsi mengembalikan ukuran buffer yang diperlukan untuk menyimpan informasi tanpa menulis informasi ke buffer.

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

Menampilkan kode	Deskripsi
ERROR_INSUFFICIENT_BUFFER	Ukuran buffer yang disediakan tidak cukup besar, atau salah diatur ke NULL.
ERROR_INVALID_PARAMETER	Nilai parameter tidak valid.
ERROR_INVALID_FLAGS	Nilai yang disediakan untuk bendera tidak valid.

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
Pustaka	Kernel32.lib
DLL	Kernel32.dll