GetNLSVersion 関数 (winnls.h)

  • [アーティクル]

識別子で指定されたロケールの指定された NLS 機能の現在のバージョンに関する情報を取得します。

メモ 相互運用性の理由から、Microsoft は新しいロケールのロケール識別子ではなくロケール名の使用に移行しているため、アプリケーションは GetNLSVersionEx 関数を GetNLSVersion よりも優先する必要があります。 この推奨事項は、特にカスタム ロケールに適用されます。 GetNLSVersionEx は 、並べ替え動作が変更されたかどうかを判断するのに十分な情報を取得します。 Windows Vista 以降でのみ実行されるアプリケーションでは 、GetNLSVersionEx を使用するか、GetNLSVersion を呼び出すときに少なくとも NLSVERSIONINFOEX 構造体を渡して、追加 の 並べ替えバージョン管理データを取得する必要があります。

 

構文

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

パラメーター

[in] Function

クエリを実行する NLS 機能。 この値はCOMPARE_STRINGする必要があります。 SYSNLS_FUNCTION列挙を参照してください。

[in] Locale

ロケール を指定するロケール識別子。 MAKELCID マクロを使用して識別子を作成するか、次のいずれかの定義済み値を使用できます。

Windows Vista 以降: 次のカスタム ロケール識別子もサポートされています。

[in, out] lpVersionInformation

NLSVERSIONINFO 構造体へのポインター。 アプリケーションでは、 dwNLSVersionInfoSize メンバーを に初期化する sizeof(NLSVERSIONINFO)必要があります。

メモ Windows Vista 以降では、 関数は NLSVERSIONINFOEX 構造体でバージョン情報を提供することもできます。
 

戻り値

アプリケーションが lpVersionInformation で有効な値を指定した場合にのみ TRUE を返し、それ以外の場合は FALSE を返します。 拡張エラー情報を取得するために、アプリケーションは GetLastError を呼び出すことができます。このエラー コードは、次のいずれかのエラー コードを返すことができます。

  • ERROR_INSUFFICIENT_BUFFER。 指定されたバッファー サイズが十分な大きさではなかったか、 正しく NULL に設定されていません。
  • ERROR_INVALID_FLAGS。 フラグに指定された値が無効です。
  • ERROR_INVALID_PARAMETER。 パラメーター値のいずれかが無効です。

解説

この関数を使用すると、Active Directory などのアプリケーションで、NLS の変更が特定のインデックス テーブルに使用されるロケール識別子に影響するかどうかを判断できます。 そうでない場合は、テーブルのインデックスを再作成する必要はありません。 詳細については、「 アプリケーションでの並べ替えの処理」を参照してください。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winnls.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

GetNLSVersionEx

アプリケーションでの並べ替えの処理

NLSVERSIONINFO

NLSVERSIONINFOEX

各国語サポート

各国語サポート関数

SYSNLS_FUNCTION