DownlevelLCIDToLocaleName 関数

ロケール識別子をロケール名に変換します。

Note

この関数は、Windows Vista 以前のオペレーティング システムで実行されるアプリケーションでのみ使用されます。 その使用にはダウンロード パッケージが必要です。 Windows Vista 以降でのみ実行されるアプリケーションでは、LCIDToLocaleName を呼び出してロケール名を取得する必要があります。

 

構文

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

パラメーター

Locale [in]

変換するロケール識別子。 MAKELCID マクロを使用して、ロケール識別子を作成できます。 この関数は、ニュートラル ロケールまたは次の特定のロケール識別子の値をサポートしていません。

• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT
• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

lpName [out]

この関数がロケール名を取得するバッファーへのポインターです。 cchName が 0 に設定されている場合、この関数は NULL を取得します。

cchName [in]

ロケール名バッファーのサイズ (UTF-16 コード ポイント)。 ロケール名バッファーの必要なサイズを返すために、アプリケーションによりこのパラメーターが 0 に設定されます。

dwFlags [in]

取得する名前の種類を指定するフラグです。 既定値は、DOWNLEVEL_LOCALE_NAME です。

戻り値

成功した場合は、ロケール名内の UTF-16 コード ポイントの数 (終端の null 文字を含む) を返します。 関数が成功し、cchName の値が 0 の場合、戻り値は文字数で (null 文字を含め) ロケール名バッファーに必要なサイズになります。

成功しなかった場合、関数により 0 が返されます。 拡張エラー情報を取得するために、アプリケーションは、次のいずれかのエラー コードを返す GetLastError を呼び出すことができます。

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

解説

Note

この関数は、カスタム ロケールをサポートしていません。

 

必要なヘッダー ファイルと DLL は、Microsoft ダウンロード センターから入手できなくなった "Microsoft NLS ダウンレベル データ マッピング API" ダウンロードの一部です。 Windows 10 May 2019 Update 以降のバージョンでは、ICU グローバリゼーション API を使用してください。

要件

要件	Value
サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
再頒布可能パッケージ	Windows XP with SP2 以降、または Windows Vista 上の Microsoft NLS ダウンレベル データ マッピング API
ヘッダー	Nlsdl.h
[DLL]	NlsMap.dll

関連項目

各国語サポート

各国語サポート関数

ロケール データのマッピング

LCIDToLocaleName