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

ITfInputProcessorProfileMgr::GetProfile 메서드는 지정된 텍스트 서비스의 프로필 또는 키보드 레이아웃에 대한 정보를 TF_INPUTPROCESSORPROFILE 구조로 반환합니다.

구문

HRESULT GetProfile(
  [in]  DWORD                    dwProfileType,
  [in]  LANGID                   langid,
  [in]  REFCLSID                 clsid,
  [in]  REFGUID                  guidProfile,
  [in]  HKL                      hkl,
  [out] TF_INPUTPROCESSORPROFILE *pProfile
);

매개 변수

[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이어야 합니다.

[out] pProfile

[out] TF_INPUTPROCESSORPROFILE 받을 버퍼입니다.

반환 값

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

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

요구 사항

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