SetProcessPreferredUILanguages 함수(winnls.h)

아티클
08/27/2023

애플리케이션 프로세스에 대한 프로세스 기본 설정 UI 언어를 설정합니다. 자세한 내용은 사용자 인터페이스 언어 관리를 참조하세요.

구문

BOOL SetProcessPreferredUILanguages(
  [in]            DWORD    dwFlags,
  [in, optional]  PCZZWSTR pwszLanguagesBuffer,
  [out, optional] PULONG   pulNumLanguages
);

매개 변수

[in] dwFlags

프로세스 기본 설정 UI 언어에 사용할 언어 형식을 식별하는 플래그입니다. 플래그는 상호 배타적이고 기본값은 MUI_LANGUAGE_NAME.

MUI_LANGUAGE_ID 대신 MUI_LANGUAGE_NAME 사용하는 것이 좋습니다.

값	의미
MUI_LANGUAGE_ID	입력 매개 변수 언어 문자열은 언어 식별자 형식입니다 .
MUI_LANGUAGE_NAME	입력 매개 변수 언어 문자열은 언어 이름 형식입니다.

[in, optional] pwszLanguagesBuffer

순서가 지정된 null로 구분된 목록을 포함하는 이중 null로 끝나는 다중 문자열 버퍼에 대한 포인터입니다. 버퍼에 5개 이상의 언어가 있는 경우 함수는 처음 5개의 유효한 언어만 설정합니다.

또는 언어 목록이 필요하지 않은 경우 이 매개 변수에 NULL 이 포함될 수 있습니다. 이 경우 함수는 프로세스에 대한 기본 UI 언어를 지웁니다.

[out, optional] pulNumLanguages

입력 버퍼의 프로세스 언어 목록에 설정된 언어 수(최대 5개)에 대한 포인터입니다.

반환 값

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

ERROR_INVALID_PARAMETER. 잘못된 매개 변수가 지정되었습니다.

프로세스 기본 설정 UI 언어 목록이 비어 있거나 프로세스에 지정된 언어가 유효하지 않으면 함수가 성공하고 pulNumLanguages 매개 변수에서 0을 설정합니다.

설명

이상적으로 애플리케이션은 시작 후 가능한 한 빨리 SetProcessPreferredUILanguages 를 호출합니다.

이 함수가 반환되면 애플리케이션은 GetProcessPreferredUILanguages 를 호출하여 결과 언어 목록을 확인하고 검사할 수 있습니다.

MUI_LANGUAGE_ID 지정한 경우 입력 매개 변수 언어 문자열은 16진수 언어를 사용해야 합니다.

앞에 오는 0x를 포함하지 않고 길이가 4자인 식별자입니다. 예를 들어 en-US는

을 "0409"로, en을 "0009"로 전달했습니다.

참고 MUI_LANGUAGE_ID MUI_LANGUAGE_NAME 사용하는 것이 좋습니다.

C# 서명

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean SetProcessPreferredUILanguages(
            System.UInt32 dwFlags,
            System.String pwszLanguagesBuffer,
            ref System.UInt32 pulNumLanguages
            );

요구 사항


지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winnls.h(Windows.h 포함)
라이브러리	Kernel32.lib
DLL	Kernel32.dll

참고 항목

GetProcessPreferredUILanguages

다국어 사용자 인터페이스

다국어 사용자 인터페이스 함수

Share via