ITfKeystrokeMgr::IsPreservedKey 方法 (msctf.h)

确定命令 GUID 和键组合是否为保留的键。

语法

HRESULT IsPreservedKey(
  [in]  REFGUID               rguid,
  [in]  const TF_PRESERVEDKEY *pprekey,
  [out] BOOL                  *pfRegistered
);

parameters

[in] rguid

指定保留密钥的命令 GUID。 这是在文本服务调用中传递给 ITfKeystrokeMgr::P reserveKey 的 GUID。

[in] pprekey

指向标识保留键 的TF_PRESERVEDKEY 结构的指针。 uVKey 成员包含虚拟密钥代码,uModifiers 成员标识保留密钥的修饰符。 uVKey 成员必须小于 256。

[out] pfRegistered

指向 BOOL 的指针,如果命令 GUID 和键组合是已注册的保留键,则接收 TRUE ,否则为 FALSE

返回值

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

说明
S_OK
方法成功,并且已找到保留的密钥。
S_FALSE
方法成功,但找不到保留的密钥。
E_INVALIDARG
一个或多个参数无效。
E_FAIL
发生了未指定的错误。

注解

保留的键由 TSF 文本服务注册,并为 TSF 文本服务实现的常见命令提供键盘快捷方式。

要求

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

另请参阅

ITfKeystrokeMgr

ITfKeystrokeMgr::P reserveKey

TF_PRESERVEDKEY