ITfInputProcessorProfiles::AddLanguageProfile 메서드(msctf.h)

특정 텍스트 서비스와 특정 언어 식별자로 구성된 언어 프로필을 만듭니다.

구문

HRESULT AddLanguageProfile(
  [in] REFCLSID    rclsid,
  [in] LANGID      langid,
  [in] REFGUID     guidProfile,
  [in] const WCHAR *pchDesc,
  [in] ULONG       cchDesc,
  [in] const WCHAR *pchIconFile,
  [in] ULONG       cchFile,
  [in] ULONG       uIconIndex
);

매개 변수

[in] rclsid

텍스트 서비스 CLSID를 포함합니다.

[in] langid

텍스트 서비스가 추가되는 프로필의 언어 식별자를 지정하는 LANGID 값을 포함합니다. 이 에 -1이 포함된 경우 텍스트 서비스가 모든 언어에 추가됩니다.

[in] guidProfile

언어 프로필을 식별하는 GUID 값을 포함합니다. 프로필이 활성 상태일 때 ITfInputProcessorProfiles::GetActiveLanguageProfile 에서 가져온 값입니다.

[in] pchDesc

프로필의 텍스트 서비스에 대한 설명 문자열을 포함하는 WCHAR 버퍼에 대한 포인터입니다. 언어 모음에 표시되는 텍스트 서비스 이름입니다.

[in] cchDesc

pchDesc에서 설명 문자열의 길이(문자)를 포함합니다. 이 에 -1이 포함된 경우 pchDesc 는 NULL로 끝나는 문자열로 간주됩니다.

[in] pchIconFile

프로필의 텍스트 서비스에 대한 언어 표시줄에 표시할 아이콘이 포함된 파일의 경로 및 파일 이름을 포함하는 WCHAR 버퍼에 대한 포인터입니다. 이 파일은 실행 파일(.exe), DLL(.dll) 또는 아이콘(.ico) 파일일 수 있습니다.

이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 경우 텍스트 서비스에 대한 기본 아이콘이 표시됩니다.

[in] cchFile

pchIconFile의 아이콘 파일 문자열 길이(문자)를 포함합니다. 이 에 -1이 포함된 경우 pchIconFile 은 NULL로 끝나는 문자열로 간주됩니다. pchIconFile이 NULL인 경우 이 매개 변수는 무시됩니다.

[in] uIconIndex

프로필의 텍스트 서비스에 대한 언어 표시줄에 표시할 pchIconFile 아이콘의 인덱스(0부터 시작)를 포함합니다. pchIconFile이 NULL인 경우 이 매개 변수는 무시됩니다.

반환 값

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

값	Description
S_OK	메서드를 성공적으로 수행했습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	pszDesc 가 잘못되었습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	msctf.h
DLL	Msctf.dll
재배포 가능 파일	Windows 2000 Professional의 TSF 1.0

추가 정보

ITfInputProcessorProfiles

ITfInputProcessorProfiles::GetActiveLanguageProfile