Fungsi GetAcceptLanguagesW (shlwapi.h)

Artikel
08/08/2024

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

Sintaks

LWSTDAPI GetAcceptLanguagesW(
  [out]     LPWSTR pszLanguages,
  [in, out] DWORD  *pcchLanguages
);

Parameter

[out] pszLanguages

Jenis: LPTSTR

Penunjuk ke string yang, ketika fungsi ini berhasil dikembalikan, menerima informasi preferensi bahasa. Kami menyarankan agar buffer ini berukuran 2048 karakter untuk memastikan ruang yang cukup untuk mengembalikan string lengkap. 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, dari string di pszLanguages.

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

Saat keluar, ini adalah ukuran sebenarnya dari pszLanguages, tidak termasuk karakter null yang mengakhiri.

Nilai kembali

Jenis: HRESULT

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

Keterangan

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 apa pun, atau ke Microsoft .NET, aplikasi atau layanan harus terlebih dahulu mengonversi tag melalui fungsi ResolveLocaleName .

Catatan

Header shlwapi.h mendefinisikan GetAcceptLanguages sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

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

Bagikan melalui