ITfReverseConversionMgr::GetReverseConversion 메서드(msctf.h)

[GetReverseConversion 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 내부 전용입니다.]

역방향 변환을 수행할 수 있는 ITfReverseConversion 개체를 검색합니다.

구문

HRESULT GetReverseConversion(
  [in]  LANGID               langid,
  [in]  REFGUID              guidProfile,
  [in]  DWORD                dwflag,
  [out] ITfReverseConversion **ppReverseConversion
);

매개 변수

[in] langid

대상 문자열이 속한 프로필의 언어 ID입니다.

[in] guidProfile

대상 문자열이 속한 프로필의 GUID입니다.

[in] dwflag

값	의미
TF_RCM_COMLESS 0x00000001	COM 없이 역방향 변환 인터페이스를 활성화합니다.
TF_RCM_VKEY 0x00000002	출력은 문자 키 코드 대신 가상 키 코드의 배열이어야 합니다.
TF_RCM_HINT_READING_LENGTH 0x00000004	역방향 변환은 입력 시퀀스의 길이에 따라 출력 목록의 항목 순서에 우선 순위를 지정하고 가장 짧은 시퀀스를 먼저 지정해야 합니다. 충돌 횟수가 적은 입력 시퀀스가 유사하지만 약간 더 높은 입력 시퀀스보다 훨씬 높을 수 있습니다. 이 플래그의 해석은 IME에 따라 다릅니다.
TF_RCM_HINT_COLLISION 0x00000008	역방향 변환은 충돌 횟수에 따라 출력 목록의 항목 순서에 우선 순위를 지정해야 하며, 먼저 충돌 수가 가장 낮은 항목을 포함해야 합니다. 입력 시퀀스가 약간 긴 입력 시퀀스보다 더 많은 문자에 해당하는 경우 더 긴 입력 시퀀스를 대신 사용하는 것이 좋습니다. IME는 이 플래그가 역방향 변환 출력에 영향을 줄지 여부를 결정합니다.

[out] ppReverseConversion

지정된 역방향 변환을 수행할 수 있는 ITfReverseConversion 개체의 주소에 대한 포인터입니다.

반환 값

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

반환 값	설명
S_OK	지정된 langid 및 guidProfile 조합에 대한 ITfReverseConversion을 사용할 수 있습니다.
E_NOTIMPL	지정된 langid 및 guidProfile 조합은 역방향 변환을 지원하지 않습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

역방향 변환은 지정된 문자열을 만드는 데 필요한 키 입력 시퀀스를 제공합니다.

dwflag에 대해 TF_RCM_HINT_COLLISION 또는 TF_RCM_HINT_READING_LENGTH 플래그를 지정하지 않으면 IME가 출력을 순서대로 정렬하지 않을 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS Vista SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	msctf.h
DLL	Msctf.dll

추가 정보

ITfReverseConversionMgr