Fungsi GetNLSVersion (winnls.h)

Artikel
03/08/2023

Mengambil informasi tentang versi kemampuan NLS yang ditentukan saat ini untuk lokal yang ditentukan oleh pengidentifikasi.

Catatan Untuk alasan interoperabilitas, aplikasi harus lebih memilih fungsi GetNLSVersionEx ke GetNLSVersion karena Microsoft bermigrasi ke penggunaan nama lokal alih-alih pengidentifikasi lokal untuk lokal baru. Rekomendasi ini berlaku terutama untuk lokal kustom, di mana GetNLSVersionEx mengambil informasi yang cukup untuk menentukan apakah perilaku pengurutan telah berubah. Aplikasi apa pun yang hanya berjalan di Windows Vista dan yang lebih baru harus menggunakan GetNLSVersionEx atau setidaknya lulus struktur NLSVERSIONINFOEX saat memanggil GetNLSVersion untuk mendapatkan data penerapan versi pengurutan tambahan.

Sintaks

BOOL GetNLSVersion(
  [in]      NLS_FUNCTION     Function,
  [in]      LCID             Locale,
  [in, out] LPNLSVERSIONINFO lpVersionInformation
);

Parameter

[in] Function

Kemampuan NLS untuk mengkueri. Nilai ini harus COMPARE_STRING. Lihat enumerasi SYSNLS_FUNCTION .

[in] Locale

Pengidentifikasi lokal yang menentukan lokal. Anda bisa menggunakan makro MAKELCID untuk membuat pengidentifikasi atau menggunakan salah satu nilai yang telah ditentukan sebelumnya berikut ini.

Windows Vista dan yang lebih baru: Pengidentifikasi lokal kustom berikut ini juga didukung.

[in, out] lpVersionInformation

Penunjuk ke struktur NLSVERSIONINFO . Aplikasi harus menginisialisasi anggota dwNLSVersionInfoSize ke sizeof(NLSVERSIONINFO).

Catatan Pada Windows Vista dan yang lebih baru, fungsi ini dapat memberikan informasi versi secara alternatif dalam struktur NLSVERSIONINFOEX .

Mengembalikan nilai

Mengembalikan TRUE jika dan hanya jika aplikasi telah menyediakan nilai yang valid dalam lpVersionInformation, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, aplikasi dapat memanggil GetLastError, yang dapat mengembalikan salah satu kode kesalahan berikut:

ERROR_INSUFFICIENT_BUFFER. Ukuran buffer yang disediakan tidak cukup besar, atau salah diatur ke NULL.
ERROR_INVALID_FLAGS. Nilai yang diberikan untuk bendera tidak valid.
ERROR_INVALID_PARAMETER. Salah satu nilai parameter tidak valid.

Keterangan

Fungsi ini memungkinkan aplikasi seperti Direktori Aktif untuk menentukan apakah perubahan NLS memengaruhi pengidentifikasi lokal yang digunakan untuk tabel indeks tertentu. Jika tidak, tidak perlu mengindeks ulang tabel. Untuk informasi selengkapnya, lihat Menangani Pengurutan di Aplikasi Anda.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	winnls.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll