LocaleNameToLCID 関数 (winnls.h)

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

構文

LCID LocaleNameToLCID(
  [in] LPCWSTR lpName,
  [in] DWORD   dwFlags
);

パラメーター

[in] lpName

ロケール名を表す null で終わる文字列へのポインター、または次の定義済み値のいずれか。

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] dwFlags

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

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

戻り値

成功した場合は、ロケール名に対応するロケール識別子を返します。

指定されたロケール名がユーザーの既定値であるカスタム ロケールに対応する場合、この関数は LOCALE_CUSTOM_DEFAULTを返します。

ロケール名が、ユーザーの既定値ではないカスタム ロケール、一時的なロケール、または CLDR (Unicode 共通ロケール データ リポジトリ) ロケールである場合、関数は LOCALE_CUSTOM_UNSPECIFIEDを返します。

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

注釈

Microsoft によって作成されたものを含むカスタム ロケールの場合、アプリケーションではロケール識別子よりもロケール名を優先する必要があります。 詳細 については、「LCID の廃止 」を参照してください。

Windows 8以降: アプリが Windows.Globalization 名前空間からこの関数に言語タグを渡す場合は、最初に ResolveLocaleName を呼び出してタグを変換する必要があります。

例

#include "stdafx.h"
#include "windows.h"
#include "stdio.h"

int _cdecl main(
    int argc,
    char *argv[])
{
    WCHAR strNameBuffer[LOCALE_NAME_MAX_LENGTH];
    DWORD error = ERROR_SUCCESS;
    LCID  lcid;

    // Get the name for locale 0x10407 (German (German), with phonebook sort)
    if (LCIDToLocaleName(0x10407, strNameBuffer, LOCALE_NAME_MAX_LENGTH, 0) == 0)
    {
        // There was an error
        error = GetLastError();
    }
    else
    {
        // Success, display the locale name we found
        wprintf(L"Locale Name for 0x10407 is %s\n", strNameBuffer);
    }

    // Get the LCID for the locale
    lcid = LocaleNameToLCID(strNameBuffer, 0);
    if (lcid == 0)
    {
        // There was an error
        error = GetLastError();
    }
    else
    {
        // Success, print the round trip LCID
        wprintf(L"LCID for %s is 0x%x\n", strNameBuffer, lcid);
    }
}

/* This code example produces the following output:

Locale Name for 0x10407 is de-DE_phoneb
LCID for de-DE_phoneb is 0x10407

*/

要件

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

関連項目

DownlevelLocaleNameToLCID

NLS: 名前ベースの API サンプル

各国語サポート

各国語サポート関数