EnumUILanguagesA 함수(winnls.h)

아티클
03/13/2024

운영 체제에서 사용할 수 있는 사용자 인터페이스 언어를 열거하고 목록의 모든 언어로 콜백 함수를 호출합니다.

구문

BOOL EnumUILanguagesA(
  [in] UILANGUAGE_ENUMPROCA lpUILanguageEnumProc,
  [in] DWORD                dwFlags,
  [in] LONG_PTR             lParam
);

매개 변수

[in] lpUILanguageEnumProc

애플리케이션 정의 EnumUILanguagesProc 콜백 함수에 대한 포인터입니다. EnumUILanguages는 이 함수를 반복적으로 호출하여 목록의 언어를 열거합니다.

[in] dwFlags

언어 형식 및 필터링을 식별하는 플래그입니다. 다음 플래그는 콜백 함수에 전달할 언어의 형식을 지정합니다. 형식 플래그는 함께 사용할 수 없으며 MUI_LANGUAGE_ID 기본값입니다.

값	의미
MUI_LANGUAGE_ID	언어 문자열의 언어 식별자를 콜백 함수에 전달합니다.
MUI_LANGUAGE_NAME	언어 문자열의 언어 이름을 콜백 함수에 전달합니다.

다음 플래그는 언어를 열거하는 데 사용할 함수에 대한 필터링을 지정합니다. 필터링 플래그는 함께 사용할 수 없으며 기본값은 MUI_LICENSED_LANGUAGES.

값	의미
MUI_ALL_INSTALLED_LANGUAGES	운영 체제에서 사용할 수 있는 설치된 모든 언어를 열거합니다.
MUI_LICENSED_LANGUAGES	사용 가능하고 사용이 허가된 설치된 모든 언어를 열거합니다.
MUI_GROUP_POLICY	사용 가능하고 사용이 허가된 모든 설치된 언어를 열거합니다. 그룹 정책입니다.

Windows Vista 이상: 애플리케이션은 dwFlags를 0으로 설정하거나 지정된 플래그 중 하나 이상으로 설정할 수 있습니다. 0을 설정하면 매개 변수 값이 기본적으로 MUI_LANGUAGE_ID | MUI_LICENSED_LANGUAGES.

Windows 2000, Windows XP, Windows Server 2003: 애플리케이션은 dwFlags를 0으로 설정해야 합니다.

[in] lParam

애플리케이션 정의 값입니다.

반환 값

성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장된 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출할 수 있습니다.

ERROR_INVALID_FLAGS. 플래그에 제공된 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.

설명

이 함수는 사용 가능한 사용자 인터페이스 언어를 열거하고 지정된 플래그에 따라 운영 체제에서 사용할 수 있는 사용이 허가된 언어를 열거합니다. 언어 식별자 또는 언어 이름을 한 번에 하나씩 EnumUILanguagesProc 콜백 함수에 전달합니다. EnumUILanguages 함수는 마지막 언어를 찾거나 콜백 함수가 FALSE를 반환할 때까지 언어 식별자 또는 이름을 콜백 함수에 계속 전달합니다.

Windows Vista 이상에서만 실행되는 애플리케이션의 경우 MUI_LANGUAGE_ID MUI_LANGUAGE_NAME 권장됩니다. MUI_LANGUAGE_NAME 추가 로캘과 연결된 언어를 구분할 수 있습니다.

이 함수에 대한 호출에서 MUI_LANGUAGE_ID 플래그를 지정하면 콜백에 전달된 문자열입니다.

함수는 선행 0x를 포함하지 않는 16진수 언어 식별자이며 4가 됩니다.

문자 길이입니다. 예를 들어 en-US는 "0409"로, en은 "0009"로 전달됩니다. "1000" 값은 추가 로캘과 연결된 모든 언어의 콜백 함수에 전달됩니다. 이 값은 LOCALE_CUSTOM_UNSPECIFIED 16진수 값에 해당합니다. 선택한 언어가 사용자 기본 설정 UI 언어 목록 또는 시스템 기본 설정 UI 언어 목록에 있더라도 추가 로캘을 구분하지 않습니다.

C# 서명

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean EnumUILanguages(
            EnumUILanguagesProc lpUILanguageEnumProc,
            System.UInt32 dwFlags,
            System.IntPtr lParam
            );

참고

winnls.h 헤더는 ENumUILanguages를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	winnls.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll