ITfInputProcessorProfileMgr::GetProfile 方法 (msctf.h)

ITfInputProcessorProfileMgr::GetProfile 方法以TF_INPUTPROCESSORPROFILE结构返回指定文本服务的配置文件或键盘布局的信息。

语法

HRESULT GetProfile(
  [in]  DWORD                    dwProfileType,
  [in]  LANGID                   langid,
  [in]  REFCLSID                 clsid,
  [in]  REFGUID                  guidProfile,
  [in]  HKL                      hkl,
  [out] TF_INPUTPROCESSORPROFILE *pProfile
);

参数

[in] dwProfileType

[in]此配置文件的类型。 这是其中一个值。

含义
TF_PROFILETYPE_INPUTPROCESSOR
这是一个文本服务。
TF_PROFILETYPE_KEYBOARDLAYOUT
这是键盘布局。

[in] langid

[in]要激活的配置文件的语言 ID。

[in] clsid

[in]要激活的配置文件的文本服务的 CLSID。 如果TF_PROFILETYPE_KEYBOARDLAYOUT dwProfileType, 则必须CLSID_NULL。

[in] guidProfile

[in]要激活的配置文件的 guidProfile。 如果TF_PROFILETYPE_KEYBOARDLAYOUT dwProfileType, 则必须GUID_NULL。

[in] hkl

[in]键盘布局的句柄。 如果TF_PROFILETYPE_INPUTPROCESSOR dwProfileType,则此值必须为 NULL

[out] pProfile

[out]要接收 TF_INPUTPROCESSORPROFILE的缓冲区。

返回值

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

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

要求

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