LocaleNameToLCID 함수(winnls.h)

  • 아티클

로캘 이름을 로캘 식별자로 변환합니다.

구문

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

매개 변수

[in] lpName

로캘 이름을 나타내는 null로 끝나는 문자열 또는 다음 미리 정의된 값 중 하나에 대한 포인터입니다.

[in] dwFlags

Windows 7 이전:예약; 는 항상 0이어야 합니다.

Windows 7부터: 중립 LCID의 반환을 허용하도록 LOCALE_ALLOW_NEUTRAL_NAMES 설정할 수 있습니다.

반환 값

성공하면 로캘 이름에 해당하는 로캘 식별자를 반환합니다.

제공된 로캘 이름이 사용자 기본값인 사용자 지정 로캘에 해당하는 경우 이 함수는 LOCALE_CUSTOM_DEFAULT 반환합니다.

로캘 이름이 사용자 기본값이 아닌 사용자 지정 로캘에 해당하거나, 일시적인 로캘이거나, CLDR(유니코드 공통 로캘 데이터 리포지토리) 로캘인 경우 함수는 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 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

DownlevelLocaleNameToLCID

NLS: 이름 기반 API 샘플

국가 언어 지원

국가 언어 지원 함수