ITfInputProcessorProfileMgr::ActivateProfile 메서드(msctf.h)

ITfInputProcessorProfileMgr::ActivateProfile 메서드는 지정된 텍스트 서비스의 프로필 또는 키보드 레이아웃을 활성화합니다.

구문

HRESULT ActivateProfile(
  [in] DWORD    dwProfileType,
  [in] LANGID   langid,
  [in] REFCLSID clsid,
  [in] REFGUID  guidProfile,
  [in] HKL      hkl,
  [in] DWORD    dwFlags
);

매개 변수

[in] dwProfileType

[in] 이 프로필의 형식입니다. 이 값은 다음 값 중 하나입니다.

값	의미
TF_PROFILETYPE_INPUTPROCESSOR	텍스트 서비스입니다.
TF_PROFILETYPE_KEYBOARDLAYOUT	키보드 레이아웃입니다.

[in] langid

[in] 활성화할 프로필의 언어 ID입니다.

[in] clsid

[in] 활성화할 프로필의 텍스트 서비스의 CLSID입니다. dwProfileType이 TF_PROFILETYPE_KEYBOARDLAYOUT 경우 CLSID_NULL 합니다.

[in] guidProfile

[in] 활성화할 프로필의 guidProfile입니다. dwProfileType이 TF_PROFILETYPE_KEYBOARDLAYOUT 경우 GUID_NULL 합니다.

[in] hkl

[in] 키보드 레이아웃의 핸들입니다. dwProfileType이 TF_PROFILETYPE_INPUTPROCESSOR 경우 NULL 이어야 합니다.

[in] dwFlags

다음 비트의 조합입니다.

값	의미
TF_IPPMF_FORPROCESS	프로세스의 모든 스레드에 대해 이 프로필을 활성화합니다.
TF_IPPMF_FORSESSION	현재 데스크톱의 모든 스레드에 대해 이 프로필을 활성화합니다.
TF_IPPMF_ENABLEPROFILE	이 사용자에 대해 이 프로필을 사용하도록 레지스트리를 업데이트합니다.
TF_IPPMF_DISABLEPROFILE
TF_IPPMF_DONTCARECURRENTINPUTLANGUAGE	현재 입력 언어가 요청된 프로필의 언어와 일치하지 않는 경우 TSF는 요청된 입력 언어가 전환될 때 이 프로필이 활성화되도록 표시합니다. 이 플래그가 꺼져 있고 현재 입력 언어가 일치하지 않으면 이 메서드가 실패합니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
S_FALSE	언어 프로필을 사용할 수 없습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2003 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	msctf.h
DLL	Msctf.dll

추가 정보

ITfInputProcessorProfileMgr

ITfInputProcessorProfileMgr::D eactivateProfile