Fungsi GetAcceptLanguagesA (shlwapi.h)

Mengambil string yang digunakan dengan situs web saat menentukan preferensi bahasa.

Sintaksis

LWSTDAPI GetAcceptLanguagesA(
  [out]     LPSTR pszLanguages,
  [in, out] DWORD *pcchLanguages
);

Parameter

[out] pszLanguages

Jenis: LPTSTR

Penunjuk ke string yang, ketika fungsi ini berhasil dikembalikan, menerima informasi preferensi bahasa. Sebaiknya buffer ini berukuran 2048 karakter untuk memastikan ruang yang cukup untuk mengembalikan string penuh. Anda juga dapat memanggil fungsi ini dengan parameter ini diatur ke NULL untuk mengambil ukuran string yang akan dikembalikan.

[in, out] pcchLanguages

Jenis: DWORD*

Penunjuk ke ukuran, dalam karakter, string di pszLanguages.

Pada entri, nilai ini adalah ukuran pszLanguages, termasuk karakter null yang mengakhiri.

Saat keluar, itu adalah ukuran aktual pszLanguages, tidak termasuk karakter null yang mengakhiri.

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT.

Komentar

Untuk versi Windows yang tidak menyertakan GetAcceptLanguages di Shlwapi.h, versi ANSI atau Unicode individual fungsi ini harus dipanggil langsung dari Shlwapi.dll. GetAcceptLanguagesA adalah ordinal 14 dan GetAcceptLanguagesW adalah ordinal 15.

Beberapa situs web menawarkan konten dalam beberapa bahasa. Anda dapat menentukan preferensi bahasa Anda di item Opsi Internet di Panel Kontrol. GetAcceptLanguages mengambil string yang mewakili preferensi tersebut. String tersebut dikirim dalam header bahasa tambahan saat menegosiasikan koneksi HTTP.

Catatan Jika aplikasi atau layanan Anda meneruskan tag bahasa dari fungsi ini ke fungsi Dukungan Bahasa Nasional , atau ke Microsoft .NET, aplikasi atau layanan Anda harus terlebih dahulu mengonversi tag melalui fungsi ResolveLocaleName .

 

Nota

Header shlwapi.h mendefinisikan GetAcceptLanguages sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	shlwapi.h
Pustaka	Shlwapi.lib
DLL	Shlwapi.dll (versi 5.0 atau yang lebih baru)