EnumUILanguagesA 함수(winnls.h)
운영 체제에서 사용할 수 있는 사용자 인터페이스 언어를 열거하고 목록의 모든 언어로 콜백 함수를 호출합니다.
구문
BOOL EnumUILanguagesA(
[in] UILANGUAGE_ENUMPROCA lpUILanguageEnumProc,
[in] DWORD dwFlags,
[in] LONG_PTR lParam
);
매개 변수
[in] lpUILanguageEnumProc
애플리케이션 정의 EnumUILanguagesProc 콜백 함수에 대한 포인터입니다. EnumUILanguages는 이 함수를 반복적으로 호출하여 목록의 언어를 열거합니다.
[in] dwFlags
언어 형식 및 필터링을 식별하는 플래그입니다. 다음 플래그는 콜백 함수에 전달할 언어의 형식을 지정합니다. 형식 플래그는 함께 사용할 수 없으며 MUI_LANGUAGE_ID 기본값입니다.
값 | 의미 |
---|---|
|
언어 문자열의 언어 식별자를 콜백 함수에 전달합니다. |
|
언어 문자열의 언어 이름을 콜백 함수에 전달합니다. |
다음 플래그는 언어를 열거하는 데 사용할 함수에 대한 필터링을 지정합니다. 필터링 플래그는 함께 사용할 수 없으며 기본값은 MUI_LICENSED_LANGUAGES.
값 | 의미 |
---|---|
|
운영 체제에서 사용할 수 있는 설치된 모든 언어를 열거합니다. |
|
사용 가능하고 사용이 허가된 설치된 모든 언어를 열거합니다. |
|
사용 가능하고 사용이 허가된 모든 설치된 언어를 열거합니다. 그룹 정책입니다. |
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 |
참고 항목
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기