LCIDToLocaleName 関数 (winnls.h)

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

メモ Microsoft によって作成されたものを含むカスタム ロケールの場合、アプリケーションではロケール識別子よりもロケール名を優先する必要があります。

 

構文

int LCIDToLocaleName(
  [in]            LCID   Locale,
  [out, optional] LPWSTR lpName,
  [in]            int    cchName,
  [in]            DWORD  dwFlags
);

パラメーター

[in] Locale

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

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

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

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

[out, optional] lpName

この関数がロケール名を取得するバッファーへのポインター、または次の定義済み値のいずれか。

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] cchName

ロケール名バッファーのサイズ (文字数)。 ロケール名の最大長 (終端の null 文字を含む) は LOCALE_NAME_MAX_LENGTH。 これは、このパラメーターに指定する推奨サイズです。

または、アプリケーションでこのパラメーターを 0 に設定することもできます。 この場合、関数はロケール名バッファーに必要なサイズを返します。

[in] dwFlags

Windows 7 より前: 予約;は常に 0 である必要があります。

Windows 7 以降: ニュートラル名を返せるように 、LOCALE_ALLOW_NEUTRAL_NAMES に設定できます。

戻り値

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

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

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

要件

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

関連項目

LocaleNameToLCID

各国語サポート

各国語サポート関数