LCIDToLocaleName 関数 (winnls.h)
メモ Microsoft によって作成されたものを含むカスタム ロケールの場合、アプリケーションではロケール識別子よりもロケール名を優先する必要があります。
構文
int LCIDToLocaleName(
[in] LCID Locale,
[out, optional] LPWSTR lpName,
[in] int cchName,
[in] DWORD dwFlags
);
パラメーター
[in] Locale
翻訳するロケール識別子。 MAKELCID マクロを使用してロケール識別子を作成するか、次のいずれかの定義済み値を使用できます。
Windows Vista: 次のカスタム ロケール識別子もサポートされています。[out, optional] lpName
この関数がロケール名を取得するバッファーへのポインター、または次の定義済み値のいずれか。
[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 |