iTfKeystrokeMgr：：GetPreservedKey 方法 (msctf.h)

获取保留密钥的命令 GUID。

语法

HRESULT GetPreservedKey(
  [in]  ITfContext            *pic,
  [in]  const TF_PRESERVEDKEY *pprekey,
  [out] GUID                  *pguid
);

[in] pic

指向应用程序上下文的指针。此值由先前对 ITfDocumentMgr：：CreateContext 的调用返回。

[in] pprekey

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

[out] pguid

指向 GUID 值的指针，该值接收保留密钥的命令 GUID。这是在 TSF 文本服务调用中传递给 ITfKeystrokeMgr：:P reserveKey 的 GUID。如果未找到保留的键，此值将接收GUID_NULL。

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

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

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