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 |
|---|---|
|
메서드를 성공적으로 수행했습니다. |
|
지정되지 않은 오류가 발생했습니다. |
|
pszDesc 가 잘못되었습니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | msctf.h |
| DLL | Msctf.dll |
| 재배포 가능 파일 | Windows 2000 Professional의 TSF 1.0 |