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	1 つ以上のパラメーターが無効です。
E_FAIL	未指定のエラーが発生しました。

保持キーは TSF テキストサービスによって登録され、TSF テキストサービスによって実装される一般的なコマンドへのキーボードショートカットを提供するために使用されます。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msctf.dll
再頒布可能パッケージ	Windows 2000 Professional 上の TSF 1.0