GetProcessPreferredUILanguages 함수(winnls.h)
프로세스 기본 설정 UI 언어를 검색합니다. 자세한 내용은 사용자 인터페이스 언어 관리를 참조하세요.
구문
BOOL GetProcessPreferredUILanguages(
[in] DWORD dwFlags,
[out] PULONG pulNumLanguages,
[out, optional] PZZWSTR pwszLanguagesBuffer,
[in, out] PULONG pcchLanguagesBuffer
);
매개 변수
[in] dwFlags
프로세스 기본 설정 UI 언어에 사용할 언어 형식을 식별하는 플래그입니다. 플래그는 함께 사용할 수 없으며 기본값은 MUI_LANGUAGE_NAME.
| 값 | 의미 |
|---|---|
|
언어 식별자 형식으로 언어 문자열을 검색합니다. |
|
언어 이름 형식으로 언어 문자열을 검색합니다. |
[out] pulNumLanguages
pwszLanguagesBuffer에서 검색된 언어 수에 대한 포인터입니다.
[out, optional] pwszLanguagesBuffer
선택 사항입니다. 함수가 순서가 지정된 null로 구분된 목록을 기본 설정 순서로 검색하는 이중 null로 끝나는 다중 문자열 버퍼에 대한 포인터로, 가장 바람직한 것으로 시작합니다.
또는 이 매개 변수가 NULL 로 설정되고 pcchLanguagesBuffer 가 0으로 설정된 경우 함수는 pcchLanguagesBuffer에서 필요한 언어 버퍼 크기를 검색합니다. 필요한 크기에는 두 개의 null 문자가 포함됩니다.
[in, out] pcchLanguagesBuffer
pwszLanguagesBuffer로 표시된 언어 버퍼의 크기(문자)에 대한 포인터입니다. 함수에서 성공적으로 반환되면 매개 변수에 검색된 언어 버퍼의 크기가 포함됩니다.
또는 이 매개 변수가 0으로 설정되고 pwszLanguagesBuffer 가 NULL로 설정된 경우 함수는 pcchLanguagesBuffer에서 필요한 언어 버퍼 크기를 검색합니다.
반환 값
성공하면 TRUE를 반환하고 그렇지 않으면 FALSE를 반환합니다. 확장된 오류 정보를 가져오기 위해 애플리케이션은 다음 오류 코드 중 하나를 반환할 수 있는 GetLastError를 호출할 수 있습니다.
- ERROR_INSUFFICIENT_BUFFER. 제공된 버퍼 크기가 충분히 크지 않거나 NULL로 잘못 설정되었습니다.
- ERROR_INVALID_PARAMETER. 매개 변수 값이 잘못되었습니다.
설명
애플리케이션에서 지정한 플래그에 따라 이 함수는 프로세스 기본 설정 UI 언어로 구성된 목록을 검색할 수 있습니다. 중복 언어가 발견되면 함수는 중복된 언어의 첫 번째 instance 검색합니다.
MUI_LANGUAGE_ID 지정하면 검색된 언어 문자열은 16진수 언어 식별자가 됩니다.
앞에 오는 0x를 포함하지 않으며 길이는 4자입니다. 예를 들어 en-US가 반환됩니다.
"0409"로, en을 "0009"로 지정합니다.
C# 서명
[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
static extern System.Boolean GetProcessPreferredUILanguages(
System.UInt32 dwFlags,
ref System.UInt32 pulNumLanguages,
System.IntPtr pwszLanguagesBuffer,
ref System.UInt32 pcchLanguagesBuffer
);
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winnls.h(Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |