iTfKeystrokeMgr：:P reserveKey 方法 (msctf.h)
注册保留的密钥。
语法
HRESULT PreserveKey(
[in] TfClientId tid,
[in] REFGUID rguid,
[in] const TF_PRESERVEDKEY *prekey,
[in] const WCHAR *pchDesc,
[in] ULONG cchDesc
);
parameters
[in] tid
包含 TSF 文本服务的客户端标识符。 此值在其 ITfTextInputProcessor：：Activate 方法中传递给 TSF 文本服务。
[in] rguid
包含保留密钥的命令 GUID。 此值将传递给 TSF 文本服务 ITfKeyEventSink：：OnPreservedKey 方法，以在激活保留密钥时标识保留的密钥。
[in] prekey
指向 TF_PRESERVEDKEY 结构的指针，该结构指定保留的键。 uVKey 成员包含虚拟密钥代码，uModifiers 成员标识保留密钥的修饰符。
[in] pchDesc
指向包含保留密钥说明的 Unicode 字符串的指针。 除非 cchDesc 为零，否则不能为 NULL。
[in] cchDesc
指定 pchDesc 中的字符数。 如果不需要说明，则为此参数传递零。
返回值
此方法可以返回其中一个值。
| 值 | 说明 |
|---|---|
|
方法成功。 |
|
已注册保留的密钥。 |
|
一个或多个参数无效。 |
|
发生内存分配错误。 |
|
发生了未指定的错误。 |
注解
保留的键由 TSF 文本服务注册，并为 TSF 文本服务实现的常见命令提供键盘快捷方式。
要求
| 最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | msctf.h |
| DLL | Msctf.dll |
| 可再发行组件 | Windows 2000 专业版上的 TSF 1.0 |
另请参阅
ITfKeyEventSink：：OnPreservedKey
ITfKeystrokeMgr：：UnpreserveKey