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

[入力]このプロファイルの種類。 これは、これらの値の 1 つです。

値	意味
TF_PROFILETYPE_INPUTPROCESSOR	これはテキスト サービスです。
TF_PROFILETYPE_KEYBOARDLAYOUT	これはキーボード レイアウトです。

[in] langid

[入力]アクティブ化するプロファイルの言語 ID。

[in] clsid

[入力]アクティブ化するプロファイルのテキスト サービスの CLSID。 dwProfileType がTF_PROFILETYPE_KEYBOARDLAYOUT場合は、この値をCLSID_NULLする必要があります。

[in] guidProfile

[入力]アクティブ化するプロファイルの guidProfile。 dwProfileType がTF_PROFILETYPE_KEYBOARDLAYOUT場合は、この値をGUID_NULLする必要があります。

[in] hkl

[入力]キーボード レイアウトのハンドル。 dwProfileType がTF_PROFILETYPE_INPUTPROCESSOR場合、これは NULL である必要があります。

[out] pProfile

[out] TF_INPUTPROCESSORPROFILEを受信するバッファー。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。
E_FAIL	未指定のエラーが発生しました。
E_INVALIDARG	1 つ以上のパラメーターが無効です。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ | UWP アプリ]
サポートされている最小のサーバー	Windows Server 2003 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msctf.dll