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 中要显示在配置文件中文本服务的语言栏中的图标的从零开始的索引。 如果 pchIconFile 为 NULL，则忽略此参数。

返回值

此方法可以返回其中一个值。

值 说明
S_OK
 方法成功。
E_FAIL
 发生了未指定的错误。
E_INVALIDARG
 pszDesc 无效。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITfInputProcessorProfiles

ITfInputProcessorProfiles：：GetActiveLanguageProfile