SetThreadUILanguage 함수(winnls.h)
현재 스레드에 대한 사용자 인터페이스 언어를 설정합니다.
Windows Vista 이상: 이 함수는 스레드 기본 설정 UI 언어 목록을 지울 수 없습니다. MUI 애플리케이션은 SetThreadPreferredUILanguages 를 호출하여 언어 목록을 지워야 합니다.
Windows XP: 이 함수는 운영 체제가 Windows 콘솔에서 사용하기에 안전한 값을 식별하고 설정할 수 있도록 제한됩니다.
구문
LANGID SetThreadUILanguage(
[in] LANGID LangId
);
매개 변수
[in] LangId
스레드의 사용자 인터페이스 언어에 대한 언어 식별자입니다.
Windows Vista 이상: 애플리케이션은 언어 식별자 0 또는 0이 아닌 식별자를 지정할 수 있습니다. 자세한 내용은 주의 섹션을 참조하세요.
Windows XP: 애플리케이션은 이 매개 변수만 0으로 설정할 수 있습니다. 이 설정으로 인해 함수는 콘솔 디스플레이를 가장 잘 지원하는 언어를 선택합니다. 자세한 내용은 주의 섹션을 참조하세요.
반환 값
성공하면 입력 언어 식별자를 반환합니다. 입력 식별자가 0이 아닌 경우 함수는 해당 값을 반환합니다. 언어 식별자가 0이면 함수는 항상 성공하고 Windows 콘솔을 가장 잘 지원하는 언어의 식별자를 반환합니다. 주의 섹션을 참조하십시오.
입력 언어 식별자가 0이 아니고 함수가 실패하면 반환 값이 입력 언어 식별자와 다릅니다. 확장된 오류 정보를 가져오기 위해 애플리케이션은 GetLastError를 호출할 수 있습니다.
설명
스레드가 만들어지면 스레드 사용자 인터페이스 언어 설정이 비어 있고 스레드의 사용자 인터페이스가 사용자가 선택한 언어로 표시됩니다. 이 함수를 사용하면 애플리케이션이 현재 실행 중인 스레드에 대한 사용자 인터페이스 언어를 변경할 수 있습니다.
Windows Vista 이상: 이 함수를 호출하고 언어 식별자에 대해 0을 지정하는 것은 MUI_CONSOLE_FILTER 플래그 집합을 사용하여 SetThreadPreferredUILanguages 를 호출하는 것과 동일합니다. 애플리케이션이 유효한 0이 아닌 언어 식별자를 지정하는 경우 함수는 스레드에 대한 특정 사용자 인터페이스 언어를 설정합니다. 언어 식별자에 대해 0을 지정한 후 애플리케이션은 언어 식별자에 해당하는 다음 상수를 사용할 수 없습니다.
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
C# 서명
[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
static extern System.UInt16 SetThreadUILanguage(
System.UInt16 LangId
);
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winnls.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |
참고 항목
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기