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

ITfInputProcessorProfileMgr::RegisterProfile 메서드는 텍스트 서비스와 프로필을 등록합니다.

구문

HRESULT RegisterProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
       const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
       const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex,
  [in] HKL         hklsubstitute,
  [in] DWORD       dwPreferredLayout,
  [in] BOOL        bEnabledByDefault,
  [in] DWORD       dwFlags
);

매개 변수

[in] rclsid

[in] 텍스트 서비스의 CLSID입니다.

[in] langid

[in] 프로필의 언어 ID입니다.

[in] guidProfile

[in] 프로필을 식별하는 GUID입니다.

pchDesc

[in, size_is(cchDesc)] 프로필에 대한 설명입니다.

[in] cchDesc

[in] pchDesc의 길이입니다.

pchIconFile

[in, size_is(cchFile] 아이콘 파일의 전체 경로입니다.

[in] cchFile

[in] pchIconFile의 길이입니다.

[in] uIconIndex

[in] 이 프로필에 대한 아이콘 파일의 아이콘 인덱스입니다.

[in] hklsubstitute

[in] 이 프로필의 대체 hkl입니다.

[in] dwPreferredLayout

[in] 사용되지 않습니다. 0이어야 합니다.

[in] bEnabledByDefault

[in] True이면 이 프로필이 기본적으로 사용하도록 설정됩니다.

[in] dwFlags

[in] 다음 비트의 조합입니다.

값	의미
TF_RP_HIDDENINSETTINGUI	이 프로필은 설정 UI에 표시되지 않습니다.
TF_RP_LOCALPROCESS	이 프로필은 로컬 프로세스에서만 사용할 수 있습니다.
TF_RP_LOCALTHREAD	이 프로필은 로컬 스레드에서만 사용할 수 있습니다.

반환 값

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

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

요구 사항

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