Bagikan melalui

Fungsi VerLanguageNameA (winver.h)

  • Artikel

Mengambil string deskripsi untuk bahasa yang terkait dengan pengidentifikasi bahasa Microsoft biner tertentu.

Sintaks

DWORD VerLanguageNameA(
  [in]  DWORD wLang,
  [out] LPSTR szLang,
  [in]  DWORD cchLang
);

Parameter

[in] wLang

Jenis: DWORD

Pengidentifikasi bahasa biner. Untuk daftar lengkap pengidentifikasi bahasa, lihat Pengidentifikasi Bahasa.

Misalnya, string deskripsi yang terkait dengan pengidentifikasi bahasa 0x040A adalah "Spanyol (Jenis Tradisional)". Jika pengidentifikasi tidak diketahui, parameter szLang menunjuk ke string default ("Language Netral").

[out] szLang

Jenis: LPTSTR

Bahasa yang ditentukan oleh parameter wLang .

[in] cchLang

Jenis: DWORD

Ukuran, dalam karakter, dari buffer yang diacu oleh szLang.

Nilai kembali

Jenis: DWORD

Nilai yang dikembalikan adalah ukuran, dalam karakter, dari string yang dikembalikan dalam buffer. Nilai ini tidak termasuk karakter null yang mengakhiri. Jika string deskripsi lebih kecil dari atau sama dengan buffer, seluruh string deskripsi berada di buffer. Jika string deskripsi lebih besar dari buffer, string deskripsi dipotok ke panjang buffer.

Jika terjadi kesalahan, nilai yang dikembalikan adalah nol. Pengidentifikasi bahasa tidak dikenal tidak menghasilkan kesalahan.

Keterangan

Fungsi ini berfungsi pada gambar file 16,32-, dan 64-bit.

Biasanya, program penginstalan menggunakan fungsi ini untuk menerjemahkan pengidentifikasi bahasa yang dikembalikan oleh fungsi VerQueryValue . String teks dapat digunakan dalam kotak dialog yang menanyakan kepada pengguna cara melanjutkan jika terjadi konflik bahasa.

Catatan

Header winver.h mendefinisikan VerLanguageName 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

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header winver.h (termasuk Windows.h)
Pustaka Version.lib
DLL Api-ms-win-core-localization-l1-2-1.dll

Lihat juga

Gambaran Umum Informasi Versi