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
);

parameters

[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
此配置文件仅在本地线程上可用。

返回值

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

说明
S_OK
方法成功。
E_FAIL
发生了未指定的错误。
E_INVALIDARG
一个或多个参数无效。

要求

   
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 R2 [桌面应用 |UWP 应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll